随着前端开发的发展，代码的提交规范已经成为了必要的标准。commitlint-config-czx 是一种使用简单、功能强大的规范包，让我们更好地管理我们的代码。
什么是 commitlint-config-czx？
commitlint-config-czx 是一个为 Git 项目提供完整的提交（commit）信息的校验工具包。它建立在 commitlint 和 cz-conventional-changelog 的基础之上，提供了一种针对 Conventional Commits 规范的校验规则。
commitlint-config-czx 帮助你确保提交信息的正确性和一致性。
怎样使用 commitlint-config-czx？
使用 commitlint-config-czx 的前提是确认你已经了解了 Conventional Commits 规范。如果你还没有，我们强烈建议先耐心阅读一遍官方文件。
安装
首先，你需要在 Git 项目中安装 commitlint 和 cz-conventional-changelog 包。
$ npm install --save-dev commitlint cz-conventional-changelog
接着，你需要安装 commitlint-config-czx 包。
$ npm install --save-dev commitlint-config-czx
配置
在项目根目录下添加 .commitlintrc.js 文件，内容如下：
-- -------------------- ---- -------
-------------- - -
-------- --------
------ -
------------ -
--
---------
-------- ------ ------- -------- ----------- ------- -------- ---------
--
------------ --- --------- --------------
------------- --- ---------
---------------- --- ---------
--------------- --- --------- -----------------
-------------------- --- --------- ----
--------------------- --- --------- ---
-
--这个文件告诉了 commitlint 使用 czx 规则，并自定义了一些规则：
- type-enum：必须指明 commit 的类型。规定了可能出现的几种类型。
- type-case：commit 的类型需要是小写的。
- type-empty：commit 的类型不允许为空。
- subject-empty：commit 的主体文本（subject）不允许为空。
- subject-case：commit 的主体文本（subject）必须按句子的句首字母使用大写。
- header-max-length：commit 的 header 部分（类型、作用域等）必须不超过 72 个字符，防止出现一行无法显示完全的情况。
- subject-max-length：commit 的主体文本（subject）必须不超过 50 个字符。
使用
当你进行 git commit 的时候，可以使用 cz-conventional-changelog 包提供的命令来进行提交信息的填写。
$ npm run commit
cz-cli@4.2.3, commitizen@4.2.4 ? Select the type of change for the commit: (Use arrow keys) > feat: A new feature fix: A bug fix docs: Documentation only changes ...
在选择好类型后会进入下一步，问你这次的变更具体是什么。填入后 commitlint 就会自动格式化信息。
如果你不想使用 npm run commit 命令，可以在 package.json 中配置：
{
"scripts": {
"commit": "cz"
}
}意义和学习
采用 commitlint-config-czx 规范项目的提交信息，让我们的代码库更具可读性、可维护性和可靠性，更便于其他开发者和工具阅读、理解和分析。
在学习 commitlint-config-czx 的过程中，我们也可以更好地掌握 Conventional Commits 规范的概念和实践，了解比较好的提交信息的写法，这对于我们以后的开发也是大有裨益的。
示例代码
一些符合规范的 git commit 示例：
-- -------------------- ---- ------- ----- --- - --- ---- --- -------- ---- ---- ------- - --- -- ----- ------- ----- ------ --- ------ ---- ------ ------ --- -- -- --- ---- ------- ---- --------- -------- --- ----------- -- --- ------- --- ----- --- ---- ----- --- --- -------- ---- ------ ------ --- ------------ -- --- ------ ------- ------- ------ --- -------- ------ ----------- --- - --- ---- -- --- -------- ---- ----------- ------- - --- -- --- ----- ---- ------------- ------ --- ------------ ----- --------------- ------ --- ----- -- --- ---- ------ -------------- -------- --- -------------- ------- ----------- --- ---- ----- --- ---- ----------- ------------ ------ ------------ -- --- -------- ------ ------- ------ --- -------- ------
结论
commitlint-config-czx 是一个强大的规范工具包，通过遵循它的规则和指南，我们可以更好地管理和规划我们的代码，提高协作的效率和代码的可靠性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600668e5d9381d61a3540aea