📚 课程目录第4章 Git作为风险登记册版本控制工具

4、Git作为风险登记册版本控制工具：Git仓库初始化、分支策略（main/dev/release）、.gitignore配置（排除敏感数据）

将风险登记册纳入版本控制，是确保其历史可追溯、变更可审计、协作可并行的关键工程实践。Git 作为分布式版本控制系统，能够为风险登记册提供原子性提交、分支隔离和细粒度权限管理。本节将聚焦 Git 仓库的初始化流程、适用于风险管理的分支策略以及敏感数据防护的 .gitignore 配置。

4.1 Git仓库初始化：从零搭建风险登记册版本库

初始化 Git 仓库是版本控制的第一步。对于风险登记册，建议采用“裸仓库 + 工作副本”分离的架构，以保障中央存储的完整性。以下为推荐初始化步骤：

创建中央裸仓库：在服务器端执行 git init --bare risk-register.git，该仓库仅存储版本历史，不包含工作目录，防止直接修改。
克隆工作副本：团队成员通过 git clone <server-path>/risk-register.git 获取本地工作副本。
设置用户信息：配置 git config user.name 和 user.email，确保每次提交都能追溯到具体责任人。
创建初始提交：添加风险登记册模板文件（如 risk-register.xlsx 或 risk-register.md），执行首次提交。

工程实践提示： 建议在初始化时即设置 git config core.hooksPath .githooks，将提交前检查（如文件格式校验、敏感信息扫描）集成到客户端钩子中，从源头拦截不合规提交。

下表总结了初始化过程中的关键配置项及其风险管理意义：

配置项	推荐值	风险管理意义
`core.bare`	`true`（中央仓库）	防止直接修改中央仓库，保障版本历史完整性
`receive.denyNonFastForwards`	`true`	禁止强制推送，避免历史被重写导致审计失效
`receive.denyDeletes`	`true`	禁止删除分支，防止风险记录意外丢失
`user.signingkey`	GPG 密钥 ID	启用提交签名，确保提交者身份不可抵赖

4.2 分支策略：main/dev/release 三级隔离模型

风险登记册的变更需要严格的审批流程。推荐采用 main / dev / release 三级分支模型，实现开发、评审与发布的环境隔离。该模型借鉴了 Git Flow 的核心思想，但针对风险登记册的审计需求进行了简化。

  核心原则： main 分支始终反映已批准的风险状态；dev 分支用于日常更新与协作；release 分支用于版本发布前的最终验证与冻结。

main 分支：保护分支，仅允许通过 Pull Request (PR) 合并。每次合并到 main 都对应一次风险登记册的正式版本发布。
dev 分支：开发主分支，团队成员在此分支上添加、修改或关闭风险条目。所有未经验证的变更均在此处。
release 分支：从 dev 分支拉出，用于准备特定版本（如月度风险报告）。在此分支上仅进行格式修正、数据校验等非功能性调整，不新增风险条目。

下图展示了三级分支模型在风险登记册版本管理中的流转关系：

避坑指南： 严禁直接在 main 分支上提交。所有变更必须经过 dev → release → main 的晋升路径。若发现紧急风险需要立即发布，应从 main 拉出 hotfix 分支，修复后合并回 main 和 dev，确保两条分支同步。

4.3 .gitignore配置：排除敏感数据与临时文件

风险登记册中可能包含项目名称、责任人联系方式、风险缓解成本等敏感信息。.gitignore 文件用于防止这些数据被意外提交到版本库。此外，还需排除操作系统临时文件、IDE 配置文件和大型二进制文件。

以下是为风险登记册仓库定制的 .gitignore 模板：

# 风险登记册敏感数据排除
*.key
*.pem
*.p12
*.cer
*.crt
passwords.txt
secrets.csv
*.env

# 办公文档临时文件
~$*.xlsx
*.xlsx~
*.tmp
*.swp
*.swo

# IDE 与编辑器配置
.idea/
.vscode/
*.suo
*.user
*.vs/

# 操作系统文件
.DS_Store
Thumbs.db
desktop.ini

# 大型二进制文件（超过 10MB）
*.zip
*.rar
*.7z
*.iso
*.dmg

# 日志与审计缓存
*.log
audit_cache/

工程实践提示： 在仓库根目录创建 .gitignore 后，执行 git add .gitignore && git commit -m "chore: add .gitignore for sensitive data" 将其纳入版本管理。若已有敏感文件被跟踪，需使用 git rm --cached <file> 从暂存区移除，并立即轮换相关凭证。

下表列出了风险登记册中常见敏感数据类型及其对应的 .gitignore 规则：

敏感数据类型	示例文件	.gitignore 规则	风险等级
身份认证凭证	vpn-key.pem, db-pass.txt	`*.pem`, `passwords.txt`	高
项目财务数据	budget-2025.xlsx	`budget-*.xlsx`	高
个人身份信息	team-contacts.csv	`-contacts.`	中
审计日志	access.log	`*.log`	中
临时备份	risk-register-backup.zip	`*.zip`	低

下图展示了 .gitignore 在提交工作流中的过滤作用：

  关键检查点： 每次提交前执行 git status 检查待提交文件列表，确认无敏感文件混入。建议在 CI/CD 流水线中集成 git-secrets 或 truffleHog 工具，自动扫描提交内容中的凭证模式。