约定式提交(Conventional Commits)

定义

约定式提交(Conventional Commits)是一份为 Git 提交信息制定的轻量级规范,要求提交说明遵循结构化格式:类型(可选作用域): 描述,例如 feat(auth): 支持扫码登录。它脱胎于 Angular 项目的提交规范,现以独立规范形式维护。

格式要点

常用类型包括:feat(新功能)、fix(缺陷修复)、docs(文档)、refactor(重构)、perf(性能)、test(测试)、build、ci、chore 等。正文之后可加脚注;破坏性变更需在类型后加感叹号(如 feat!:)或写 BREAKING CHANGE: 脚注。

与语义化版本联动

规范与 SemVer 天然对应:fix 对应修订号、feat 对应次版本号、破坏性变更对应主版本号。据此,semantic-release、release-please、standard-version 等工具可在 CI 中自动判定新版本号、生成 CHANGELOG 并发布,免去手工维护。

配套工具

commitlint 校验提交信息格式,husky 在 git hook 中拦截不合规提交,commitizen 提供交互式撰写向导。批评者认为机械分类对小团队价值有限,规范本身也提醒不必强求所有贡献者掌握。