npm 包 gw-commit-lint 使用教程

阅读时长 3 分钟读完

随着前端应用不断增多,我们面临的代码质量问题变得越来越重要。要保证代码质量,让代码风格统一,我们可以使用 gw-commit-lint 这个 npm 包来进行代码审查和约束。

什么是 gw-commit-lint

gw-commit-lint 是一个基于 Git commit message 的规范性检查工具。它可以检查我们的 commit message 是否符合预先定义的规范。

安装

首先,需要全局安装 gw-commit-lint:

使用

安装完成后,我们可以在项目的根目录下进行如下配置:

package.json 中,添加如下配置:

这里选用了 @guangzhou/preset-config-gitlly 这个 preset,也就是预先配置好了一些常用的规则和错误提示,可以在根目录下的 commitlint.config.js 中进行配置。

为了使我们的每一次 Git commit 都能受到检查,我们可以在 package.jsonscripts 中添加:

这样在每次进行 Git commit 操作时,gw-commit-lint 都会对我们的 commit message 进行检查,确保格式规范。

指南

gw-commit-lint 已经提供了一些配置模板,我们只需要在其基础上进行修改即可。以下是一些常用的规则指南:

  • 【规则1】[feat] 新特性/功能

    git commit -m "feat: add new feature A"

  • 【规则2】[fix] bug 修复

    git commit -m "fix: fix bug A"

  • 【规则3】[docs] 文档更新

    git commit -m "docs: add/update document A"

  • 【规则4】[style] 代码格式/样式调整

    git commit -m "style: update code style A"

  • 【规则5】[refactor] 代码重构

    git commit -m "refactor: refactor code A"

  • 【规则6】[test] 测试相关

    git commit -m "test: add test for feature A"

  • 【规则7】[chore] 构建/工具/文档等其他更新

    git commit -m "chore: update build script A"

以上是一些常见的规则设定,也可以根据自身项目的实际情况进行修改。

示例代码

在使用中,如果发现不符合规则,会收到如下警告信息:

祝大家使用 gw-commit-lint 愉快,早日拥有代码质量信仰!

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

纠错
反馈