← 中文资源

简体中文版本

版本打标签与变更日志工作流

依据提交历史决定语义化版本号、创建签名标签,并按变更类型生成变更日志。

阅读英文原文

目标

发布需要一致且可验证的版本标签,以及能说明变更内容与原因的变更日志。本工作流根据上次标签以来的提交类型决定 major/minor/patch,生成按特性、修复与破坏性变更分组的日志,创建并验证签名标签,最后发布日志并链接到该版本的构建产物。

步骤要点

  1. 依据提交类型决定版本号变更。
  2. 生成按类型分组的变更日志。
  3. 创建并验证签名标签。
  4. 发布日志并链接对应产物。
git tag -s v1.9.0 -m 'release v1.9.0'
git verify-tag v1.9.0
git push origin v1.9.0

验证

按顺序执行上述步骤后,逐项确认每个步骤的预期状态均已满足;只有全部预期状态成立,才认为本流程完成。若某一步未达到预期状态,应先按排错提示排查,不要跳过继续,以免掩盖问题。

排错提示

  • 凭猜测决定版本号不可靠。
  • 无签名标签削弱供应链验证。
  • 日志遗漏破坏性变更会让用户意外。

适用边界

  • 依赖规范的提交历史。
  • 需要打标签与写入权限。