首页/开发/CI/CD 与发布速查/约定式提交(Conventional Commits)
工具链要点63 条

约定式提交(Conventional Commits)

提交信息采用「类型(范围): 描述」格式:机器可解析,可据此生成变更日志与推断版本号,支撑自动化发布。

CI/CD 与发布速查开发更新于 2026-10-12
格式type(scope): subject
常用类型feat、fix、docs、chore、refactor
语义feat 对应次版本、fix 对应修订号(配合工具)
工具commitlint 校验、semantic-release 自动发布

提交示例

提交示例
feat(api): 支持批量导入订单
fix(cart): 修复优惠券重复计算
docs: 更新部署说明

BREAKING CHANGE: 删除旧版接口
格式校验交给 commitlint,版本与日志交给发布工具:约定才能落地。

易错点

  • 提交信息随意:自动版本推断失效,版本维护回到手工
  • 只在本地约定:合并与压缩提交会丢失格式

数据来源与参考

  • Conventional Commits 1.0.0(conventionalcommits.org)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌