Skip to content

commitlint

commitlint 是一个用于检查 git commit 提交消息是否规范的工具。

安装

sh
npm install -D @commitlint/cli

配置

执行以下脚本,生成 commitlint.config.mjs 配置文件。

sh
echo "export default {extends: ['@commitlint/config-angular']};" > commitlint.config.mjs

注意

Windows 下 echo > 创建的文件编码格式为 UTF-16LE 会导致报错,正确格式应为 UTF-8,所以请手动创建 commitlint.config.mjs 文件并写入配置export default {extends: ['@commitlint/config-angular']};

@commitlint/config-angular

推荐使用 @commitlint/config-angular 配置,也可自行配置

sh
npm install -D @commitlint/config-angular

commit 类型

提交类型作用描述
feat新增功能或特性(触发次版本号更新)
fix修复程序错误/Bug(触发修订号更新)
docs文档更新(README、注释等非代码变更)
style代码格式调整(空格/缩进/分号等,不改变逻辑)
refactor代码重构(优化结构但不影响功能)
perf性能优化(提升执行效率)
test测试相关变更(添加/修改测试用例)
build构建系统或依赖更新(Webpack/npm/Maven 等)
ci持续集成配置(GitHub Actions/Jenkins/Travis CI 等)
revert撤销之前的某次提交

集成到 Husky

确保已完成 Husky 的步骤,随后执行以下脚本后即可以使用。

sh
echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg

注意

Windows 下 echo > 创建的文件编码格式为 UTF-16LE 会导致报错,正确格式应为 UTF-8,所以请手动创建 .husky/commit-msg 文件并写入配置npx --no -- commitlint --edit $1