如何规范 git commit 信息

commit message

每次 git commit 我们都要写 commit message(提交说明)。

如果一行信息足够了，可以执行 git commit -m 'hello world。

如果想要输入更多信息，可以执行 git commit 调出编辑器填入多行信息。

理论上 commit message 写什么都行，不过为了项目的可维护性，规范还是要有的。

社区有很多规范，这里只列举 commit 的类型：

当然，靠自觉来遵守规范是不太现实的，所以，还是用工具吧。commitlint 就是一个用来检查 commit message 是否符合规范的工具。

安装

第一步：安装 commitlint cli

npm i -D @commitlint/cli

第二步：安装规范，这里安装的是 config-conventional，也可以选择其他规范

npm i -D @commitlint/config-conventional

配置

// commitlint.config.js
module.exports = {
    // 指定要用的规范
    extends: ['@commitlint/config-conventional'],
};

使用

npx commitlint --from HEAD~1 --to HEAD --verbose

当然，这没什么 🥚 用。我们要的是在 commit 前就检查信息是否符合规范，如果不符合就阻止他提交。

这里已经介绍过 husky 是干什么的了。

配置

{
    "hooks": {
        // 在提交 commit 信息的时候运行 commitlint 命令
        "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }
}

Last updated 3 years ago