第 0 章 准备工作

本章解决新成员最易受阻的第一步：本机装好 Git、配好本地身份、并从 Gitea 取到仓库地址。后续的 clone、commit、push、PR 均建立在本章之上。

实验室代码托管在内部的 Gitea 平台（仓库、Issue、Pull Request、Code Review 均在此完成），不使用 GitHub。凡涉及远程地址、网页操作之处，均以实验室 Gitea 为准，域名向管理员索取。

实验室为 Windows 环境，本手册命令默认在 PowerShell 中执行。所有 git 命令与系统命令均使用 PowerShell 语法。

0.1 安装 Git

安装 Git for Windows，保持默认选项。安装完成后打开 PowerShell，验证：

git --version

输出类似 git version 2.45.0 即为成功。

0.2 配置本地身份与两项全局设置

以下配置属于本机 Git 工具，与 Gitea 账号无关，但不可省略：Git 在每次 git commit 时读取 user.name 与 user.email 写入提交历史，未配置将无法提交。（注：使用英文输入姓名，例如：张三，应当写作：San Zhang）

git config --global user.name "你的真实姓名"
git config --global user.email "你的邮箱"

姓名与邮箱会写入 commit 历史，须填真实信息。检查：git config --global --list。

再做两项全局设置，长期生效：

git config --global pull.rebase true    # pull 时用 rebase，保持历史线性
git config --global core.autocrlf false # 换行符统一交给仓库的 .gitattributes 管理

换行符（Windows 的 CRLF 与 Linux 的 LF）不必自己纠结：实验室仓库都带 .gitattributes 统一策略，你只需把 core.autocrlf 设为 false 且不再手动改动，即可避免与仓库策略冲突产生满屏假 diff。

0.3 激活 Gitea 账号

访问https://git.nnugnss.cc.cd/输入账号密码（账号：学号+@njnu.edu.cn,默认密码：nnugnss123），激活账号。

0.4 参考样例：配套练习仓库

本手册配套练习仓库 lab-git-practice，每章对应一个操作样例。

获取方式：

1. 访问实验室 Gitea，找到 lab-git-practice 模板仓库
2. 点 Fork 到自己账号
3. 克隆：

git clone https://<实验室Gitea域名>/<你的账号>/lab-git-practice.git
cd lab-git-practice

1. 自检：

python scripts/check-quest.py 0

---