本包提供了《Git 规约》配套的 commitlint 可共享配置,用于对 git commit message 进行校验。
除了本包,你需要同时安装 @commitlint/cli:
npm install @winner-fed/commitlint-config-win @commitlint/cli --save-dev
本包同时支持 CommonJS 和 ESM 模块系统。
在项目中的 commitlint.config.js
中继承本包:
module.exports = {
extends: ['@winner-fed/commitlint-config-win'],
};
在项目中的 commitlint.config.mjs
中继承本包:
export default {
extends: ['@winner-fed/commitlint-config-win'],
};
或者在 package.json
中设置 "type": "module"
后,在 commitlint.config.js
中使用:
export default {
extends: ['@winner-fed/commitlint-config-win'],
};
如果你使用 TypeScript,可以在 commitlint.config.ts
中使用:
import type { UserConfig } from '@commitlint/types';
const config: UserConfig = {
extends: ['@winner-fed/commitlint-config-win'],
};
export default config;
可通过 husky 设置在 git commit 时触发 commitlint。
首先安装 husky:
npm install husky --save-dev
然后在 package.json
中增加:
{
"husky": {
"hooks": {
"commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
}
}
}
更多信息可参考 commitlint 文档。