npm 包 validate-git-commit-message 使用教程

阅读时长 4 分钟读完

很多开发者在提交 Git 代码时都有使用规范化的 commit message 的习惯,以方便后期代码维护及回退。但是如果不同的开发者习惯不同,规范不同,就会导致提交信息的混乱。这时就需要一个工具来规范化这些提交信息,这就是 validate-git-commit-message 工具。

validate-git-commit-message 是一个用来检查 commit message 的格式是否符合规范的 npm 包,它可以检测出 message 格式不正确的情况,从而提醒开发者使用规范的 commit message。

本文介绍了如何使用 validate-git-commit-message 工具来检测 Git commit message 的规范化情况,并提供了示例代码和实践案例。

安装

使用 npm 镜像源安装 validate-git-commit-message:

使用方法

在项目根目录创建一个 .validate_git_commit_msg.js 文件并写入以下代码:

这个文件的作用是读取在 Git 中提交的 commit message 文件,并验证其格式是否符合规范。

并在 package.json 文件中添加 commit-msg 钩子:

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

其中 husky 是一个为 Git 提供钩子的工具,它提供了一个 commit-msg 钩子来验证提交信息的格式是否符合规范。

这样,当你通过 git commit 提交代码时,validate-git-commit-message 会自动检测 commit message 的格式是否符合规范化要求。

示例代码

下面是一些符合规范化要求的 commit message 格式示例:

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

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

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

----- ----

----- ------

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

------ -----

------ ----

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

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

如果 commit message 不符合规范化,validate-git-commit-message 会提示提交信息修改后再次提交。

实践案例

应用 validate-git-commit-message 工具可以巨大提高代码开发维护的效率、降低维护成本和避免不必要的错误和风险等。

在一些大型项目中,所有提交必须遵守特定的 commit message 格式,而不仅仅是一个习惯。因此在项目中使用 validate-git-commit-message 工具就显得尤为重要。

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

纠错
反馈