4. 迁移文件的版本号管理：语义化版本号（SemVer）在数据库迁移中的应用

在数据库迁移的版本协同中，版本号不仅是文件命名的标识，更是团队判断变更顺序、依赖关系和冲突风险的唯一依据。语义化版本号（SemVer）为迁移文件提供了一套可读、可排序、可推理的编号规则，让 Git 仓库中的每一次数据库变更都能被精确追踪。

4.1 为什么数据库迁移需要语义化版本号

数据库迁移与应用程序代码不同：迁移文件之间存在严格的执行顺序，且一旦应用到生产环境，回滚成本极高。使用简单的递增数字（如 001.sql、002.sql）在多人并行开发时极易产生冲突，而语义化版本号通过三段式结构解决了以下核心问题：

• 顺序确定性：主版本号决定迁移的全局执行顺序，避免分支合并后出现乱序。
• 变更类型标识：次版本号区分新增、修改、回滚等不同性质的变更。
• 补丁与热修复：补丁号用于紧急修复已发布的迁移，不影响整体版本演进。

4.2 语义化版本号的三段式结构

针对数据库迁移场景，我们推荐采用 MAJOR.MINOR.PATCH 格式，并附加可选的构建元数据：

4.3 通过版本号追踪变更顺序

语义化版本号在数据库迁移中的核心价值在于：版本号的字典序即执行顺序。以下 SVG 图展示了从版本创建到合并、再到部署的完整追踪链路：

4.4 版本号冲突与解决策略

在多人协作的 Git 工作流中，版本号冲突是最常见的协同问题。以下表格列出了典型冲突场景及对应的解决策略：

4.5 版本号在 Git 提交中的关联

为了让版本号真正可追踪，需要将迁移文件的版本号与 Git 提交信息建立强关联。推荐在每次提交时，将版本号写入提交信息的固定位置，便于后续自动化工具解析：

# 提交信息模板
feat(db): V2.1.0 新增用户角色表

- 迁移文件: V2_1_0__create_user_role.sql
- 回滚文件: R2_1_0__create_user_role.sql
- 变更类型: MINOR (新增表)
- 依赖版本: V2.0.0
- Review ID: PR-342

4.6 自动化版本号校验

在 CI/CD 流水线中，可以加入版本号校验步骤，确保合并到主分支的迁移文件满足以下规则：

• 唯一性校验：同一目录下不允许存在两个相同版本号的迁移文件。
• 单调递增校验：新合并的迁移文件版本号必须大于当前已部署的最新版本号。
• 格式校验：版本号必须符合 MAJOR.MINOR.PATCH 三段式，且每段为整数。
• 依赖完整性校验：如果迁移文件声明了依赖版本，该依赖版本必须存在于迁移历史中。

以下 SVG 图展示了自动化版本号校验在 CI/CD 流水线中的执行流程：

4.7 版本号与分支策略的协同

不同的 Git 分支策略对版本号的管理方式略有差异。以下表格总结了三种主流策略下的版本号管理要点：