commitlint校验git提交信息

1、安装

// 一次安装两个包，@commitlint下面cli和config-conventional子包
npm install --save-dev @commitlint/{cli,config-conventional}

2、配置文件

// echo 'code' > [file] 输出代码到file文件，默认覆盖文件，如果没有file文件，会自动新增
// echo输出代码到commitlint.config.js文件，会创建commitlint.config.js
// module.exports 表示cjs规范导出
echo "module.exports { extends: ['@commitlint/config-conventional'] };" > commitlint.config.js

3、husky

在提交或推送时自动检查你的提交消息、代码并运行测试。自定义git提交时的钩子

npm install --save-dev husky
// 将生成 .husky文件
npx husky init
// 提交commit消息校验；$1表示commitlint默认配置，这是husky新版本的写法
echo "npx --no-install commitlint --edit $1" > .husky/commit-msg

4、格式

// :后有一个空格
<type>[optional scope]: <subject>
// 换行
[optional body]
// 换行
[optional footer(s)]

// 例子
fix(range): preblom

5、自定义本地配置

// commitlint.config.js
module.exports = { 
  extends: ['@commitlint/config-conventional'],
  rules: {
   // 例子：type只能写fix或者feat
    "type-enum": [2, "always", ["fix", 'feat']],
  }
};
// rules；自定义rules优先于默认规则
// conditionLevel 可选0，1，2；0表示不使用规则，1表示警告，2使用规则并且会报错
// Applicable可选 always、never，always表示总是使用value；never表示从不使用value
// Value表示匹配值，可以是string|number|[]
"rule-name": [conditionLevel, Applicable, Value]
// 例子：规定内容subject最大长度不超过5，否则会报错（2表示报错）
"subject-max-length": [2, 'always', 5],