npm 包 commitlint-config-awesome 使用教程

阅读时长 3 分钟读完

在开发一个团队项目时,代码规范和代码风格的一致性是非常重要的。而在代码版本控制和管理中,commit message 更是起到非常重要的作用。为了规范化项目的 commit message,我们可以使用一个 npm 包——commitlint-config-awesome。

commitlint-config-awesome 是什么?

commitlint-config-awesome 是一个已经定义好的规则配置,它使用 commitlint 这个验证 commit message 规则的工具来保证我们项目中的代码提交信息(commit message)符合一定的规范。commitlint-config-awesome包含了大多数常用的 commit message 规则。比如:模块名、编号、描述、M大写等等。

commitlint-config-awesome 用法

进入你的项目目录,安装 commitlint 和 commitlint-config-awesome 这两个依赖。在终端里输入以下命令:

安装好后,我们还需要定义一条 commit message 格式规则。打开 package.json 文件,添加一个 commitlintConfig 属性:

commitlint-config-awesome 默认使用了 @commitlint/config-conventional 规则,因此我们不用再次定义。如果你只想使用 commitlint-config-awesome 中的某些规则,也可以自行在该属性中配置。

之后,我们只需要按照配置好的格式来书写 commit message 信息,例如:

以上的示例 commit message 包含了以下信息:

  • feat(ui):特性(feature) + 模块名
  • 添加登录页面:描述信息
  • #1:编号

commit message 格式规范

下面是 commit message 的格式规范:

-- -------------------- ---- -------
---------------- ------ ----

------
------
------

------
------
---

-----------------

commit message 的各个部分确认含义如下:

  • type:必须存在。表示一次提交的类型,常用的有 feat、fix、docs 等。
  • scope:表示改动的范围,例如:ui、service、model 等。
  • 描述信息:必须存在。简短明了的描述信息,最好不要超过 50 个字符。
  • 编号:可选。该次提交对应的 issue 编号。
  • 描述信息:可选。对该次提交做详细描述。

结语

commitlint-config-awesome 这个 npm 包的使用方法非常简单,它可以帮助我们统一 commit message 规范,提高项目的开发效率和质量。在实际项目中,我也建议大家使用该 npm 包来规范化我们的 commit message ,让我们的代码更加规范易读,为团队的合作提供支持。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedc5f4b5cbfe1ea0612224

纠错
反馈