用途:在编写 Git 提交信息、任务完成需要提交改动、或项目使用 semantic-release、commitizen、git-cliff 时,按 Conventional Commits v1.0.0 规范生成结构化提交历史,以支持自动化变更日志与语义化版本。
主要能力:规范提交信息结构 <type>[可选 scope]: <description> + 可选 body + 可选 footer;区分必需类型 feat、fix 及 Angular 惯例类型 build、ci、docs、perf、refactor、style、test 等;支持用 ! 或 BREAKING CHANGE 标注破坏性变更;将提交类型映射到语义化版本(fix→PATCH,feat→MINOR,破坏性变更→MAJOR);提供头部校验正则与 Python 校验示例用于格式合规检查。
使用方式:提交信息以类型加冒号空格开头,如 feat: add user authentication;可加 scope 如 feat(lang): add Polish language;破坏性变更可用 feat!: ... 或 footer 中 BREAKING CHANGE: ...;正文需在描述后空一行开始,footer 每个条目标记后用 :+空格 或 空格+# 分隔。描述建议使用祈使现在时、首字母不大写、结尾不加句号,整行控制在 72 字符以内。
适用场景:需要规范化提交历史、设置 commitlint 校验、配置从提交历史生成变更日志、实现语义化版本自动化、评审或培训团队提交规范时。
限制:资料未提供具体安装命令或配置代码;范围、正文、footer 为可选项,类型大小写除 BREAKING CHANGE 须大写外不敏感;自定义类型虽可扩展,但工具支持程度可能不同。