📚 课程目录第3章版本管理基础

3、版本管理基础：版本管理的概念、为什么风险登记册需要版本管理、常见版本管理工具（Git、SVN）简介

3.1 版本管理的核心概念

版本管理（Version Control），又称修订控制或源码管理，是一种记录一个或多个文件内容变化，以便将来查阅特定版本修订情况的系统。在风险登记册的语境下，版本管理意味着对风险条目、参数配置、预警阈值及应对措施的每一次修改进行快照保存，并允许用户回溯、比较和合并不同时期的状态。

  核心三要素：
  版本快照：每次提交（Commit）生成一个不可变的版本标识（如 Git 的 SHA-1 哈希值或 SVN 的修订号）。
变更追踪：精确记录“谁、在什么时间、修改了哪个字段、从什么值改为什么值”。
分支与合并：支持并行开发不同场景下的风险预案（如“乐观情景”与“悲观情景”分支），随后合并回主基线。

3.2 为什么风险登记册需要版本管理

风险登记册不是静态文档，而是随项目推进持续演变的动态资产。缺乏版本管理将导致以下典型问题：

问题场景	无版本管理的后果	版本管理带来的价值
风险参数误改（如阈值被意外调低）	无法恢复原始值，需人工回忆或重录	一键回滚至任意历史版本
多人同时更新风险条目	覆盖冲突，丢失最新分析结果	分支隔离 + 合并冲突提示
审计或合规检查	无法证明某次变更的准确时间与责任人	完整提交日志，满足审计追溯要求
多情景风险预案管理	需复制整个文件，容易混淆基线	分支管理不同情景，主线保持稳定

最佳实践：建议将风险登记册的版本管理策略与项目里程碑对齐。每个里程碑节点强制创建一次基线版本（Tag），确保关键决策点的风险状态可复现。

3.3 常见版本管理工具简介

当前业界主流版本管理工具分为集中式（SVN）和分布式（Git）两类。下表从风险登记册管理的角度进行对比：

特性维度	Git（分布式）	SVN（集中式）
架构模式	每个本地仓库包含完整历史	中央服务器存储所有版本
离线操作	完全支持，本地可提交、查看日志	大部分操作需联网
分支成本	极低，分支创建与切换为本地操作	较高，分支本质是目录拷贝
适合场景	多情景并行、频繁迭代、团队协作	单一基线、权限控制严格、非技术团队
风险登记册典型用法	每个情景一个分支，主分支为基线	目录结构区分情景，锁定文件防冲突

3.4 风险登记册版本管理的参数配置要点

在将风险登记册纳入版本管理时，需关注以下参数配置：

文件格式选择：推荐使用纯文本格式（如 JSON、YAML、CSV）存储风险条目，便于 Git/SVN 进行差异对比（Diff）。避免使用二进制格式（如加密的 Excel 或 PDF）。
.gitignore 或 svn:ignore 配置：排除临时文件、日志文件、本地缓存，确保版本库只包含核心风险数据。
提交信息规范：强制要求每次提交附带结构化信息，例如：[风险ID-1023] 调整概率等级从“高”至“中”，依据最新评估报告 v2.1。
分支命名策略：建议采用 情景/风险类别/日期 格式，如 scenario/optimistic/2025-06。

常见陷阱：不要将风险登记册的版本管理等同于简单的“另存为”文件命名（如 风险登记册_v1_final_最终版.xlsx）。这种人工方式无法保证变更的原子性、可追溯性和并行协作能力。

3.5 版本管理工具的基本操作示例

以下展示 Git 在风险登记册管理中的典型操作流程：

# 初始化本地仓库
git init risk-register
cd risk-register

# 添加风险登记册文件（假设为 JSON 格式）
git add risk_register.json

# 首次提交，创建基线版本
git commit -m "[INIT] 创建风险登记册基线 v1.0，包含 45 条初始风险条目"

# 创建“乐观情景”分支
git branch scenario/optimistic

# 切换到该分支进行参数调整
git checkout scenario/optimistic
# ... 修改风险参数 ...
git add risk_register.json
git commit -m "[SCENARIO] 乐观情景：降低 3 条风险的预警阈值至 0.6"

# 切换回主分支，合并乐观情景的变更
git checkout main
git merge scenario/optimistic -m "[MERGE] 合并乐观情景参数调整至主基线"

对于 SVN 用户，对应的操作逻辑类似，但分支通常通过目录拷贝实现：

# 创建分支（SVN 中分支是目录拷贝）
svn copy ^/trunk ^/branches/scenario-optimistic -m "创建乐观情景分支"

# 切换工作副本至分支
svn switch ^/branches/scenario-optimistic

# 提交变更
svn commit -m "乐观情景：调整风险 R-003 的应对措施优先级"

# 合并回主干
svn switch ^/trunk
svn merge ^/branches/scenario-optimistic
svn commit -m "合并乐观情景分支至主干"

选型建议：如果团队以非技术人员为主（如风险管理专员、业务分析师），且对离线操作需求不高，SVN 的集中式模型和图形化客户端（如 TortoiseSVN）可能更易上手。如果团队包含开发人员，或需要频繁进行多情景并行推演，Git 的轻量分支特性将显著提升效率。