4. 版本控制系统：Git安装、SSH密钥配置、仓库初始化与分支策略（Git Flow）

在工程项目偏差分析中，承诺跟踪的可靠性高度依赖于版本控制系统的严谨配置。Git 作为分布式版本控制的事实标准，能够完整记录每一次承诺变更、偏差分析结果与配置快照。本节将系统讲解 Git 的安装验证、SSH 安全认证、仓库初始化流程以及 Git Flow 分支策略的落地规范。

4.1 Git 安装与环境验证

Git 支持 Windows、macOS 与 Linux 三大平台。安装完成后，必须通过以下命令验证版本并设置全局身份，确保提交记录可追溯至具体责任人。

# 设置全局用户名与邮箱（必须与承诺跟踪责任人一致）
git config --global user.name "Zhang San"
git config --global user.email "zhangsan@project-commitment.com"

# 查看配置
git config --list

4.2 SSH 密钥配置与安全认证

SSH 协议相比 HTTPS 免去了每次推送输入密码的繁琐操作，且安全性更高。在团队协作的承诺跟踪场景中，SSH 密钥是连接本地仓库与远程服务器的标准方式。

4.2.1 密钥生成与添加

# 生成 ED25519 密钥（推荐，安全性优于 RSA）
ssh-keygen -t ed25519 -C "zhangsan@project-commitment.com"

# 按提示设置密钥存储路径（默认 ~/.ssh/id_ed25519）
# 可选设置 passphrase（建议设置，增加安全性）

# 查看公钥内容
cat ~/.ssh/id_ed25519.pub

4.2.2 将公钥添加到远程仓库（如 GitLab / GitHub）

1. 登录远程仓库平台，进入 Settings → SSH Keys。
2. 将 id_ed25519.pub 内容完整粘贴到公钥输入框。
3. 设置密钥标题（如 ZhangSan_Work_Laptop），保存。

4.2.3 连接测试

ssh -T git@gitlab.example.com
# 成功提示：Welcome to GitLab, @zhangsan!

4.3 仓库初始化与远程关联

工程项目通常采用“先创建远程仓库，再克隆到本地”的工作流。以下为标准初始化步骤：

# 方式一：克隆已有远程仓库（推荐）
git clone git@gitlab.example.com:project/commitment-tracking.git
cd commitment-tracking

# 方式二：本地初始化后关联远程
mkdir commitment-tracking
cd commitment-tracking
git init
git remote add origin git@gitlab.example.com:project/commitment-tracking.git

# 创建初始提交
echo "# 承诺跟踪项目 - 偏差分析" > README.md
git add README.md
git commit -m "chore: 初始化仓库，添加项目说明"
git push -u origin main

4.4 Git Flow 分支策略

Git Flow 是一种成熟的分支管理模型，特别适合具有明确版本发布周期的工程项目。在承诺跟踪与偏差分析场景中，它能够隔离开发中的承诺变更与已发布的基线数据。

4.4.1 核心分支结构

4.4.2 分支操作流程

4.4.3 承诺跟踪场景下的分支策略示例

假设项目需要新增“偏差分析报告自动生成”功能，对应的 Git Flow 操作如下：

# 1. 从 develop 创建 feature 分支
git checkout develop
git pull origin develop
git checkout -b feature/CT-042-auto-report

# 2. 开发与提交（多次提交）
git add .
git commit -m "feat: 添加偏差报告模板引擎"
git commit -m "feat: 实现数据导出接口"

# 3. 合并回 develop
git checkout develop
git pull origin develop
git merge --no-ff feature/CT-042-auto-report
git branch -d feature/CT-042-auto-report
git push origin develop

# 4. 创建 release 分支准备发布
git checkout -b release/v1.2.0
# 进行版本号更新、最终测试
git commit -m "chore: bump version to v1.2.0"

# 5. 合并到 main 并打标签
git checkout main
git merge --no-ff release/v1.2.0
git tag -a v1.2.0 -m "发布 v1.2.0：新增偏差报告自动生成"
git push origin main --tags

# 6. 同步回 develop
git checkout develop
git merge --no-ff release/v1.2.0
git branch -d release/v1.2.0
git push origin develop

4.5 分支策略与承诺跟踪的映射关系

将 Git Flow 分支与承诺跟踪生命周期对齐，可以显著提升偏差分析的可追溯性：