npm 包 @codoonfxd/commitlint-config 使用教程

前言

在前端开发中,版本控制是一项非常重要的工作。版本控制不仅可以记录代码的历史修改记录,还能够协助开发团队管理代码,保证代码的质量和稳定性。

在版本控制的实践中,Commit Message 是一项非常重要的内容。优秀的 Commit Message 不仅能够让记录更加清晰,还能协助代码审查、版本控制和追踪问题。

为了让 Commit Message 规范化,可以使用一些工具完成自动化的格式化和校验。本文介绍的 npm 包 @codoonfxd/commitlint-config 就是其中一个非常优秀的工具。

什么是 @codoonfxd/commitlint-config?

@codoonfxd/commitlint-config 是一个基于 commitlint 的配置工具,用于规范化 Commit Message 的格式。

commitlint 是一个可以帮助我们检查和规范 Commit Message 的工具。commitlint 需要使用一组规则来完成检查的工作。而 @codoonfxd/commitlint-config 则提供了一组优秀的规则配置,可以简化我们的配置工作,让我们专注于 Commit Message 的质量和可读性。

安装和使用

安装 @codoonfxd/commitlint-config 依赖:

npm install --save-dev @codoonfxd/commitlint-config

在项目根目录中创建 commitlint.config.js 文件,并加入以下代码:

module.exports = {
  extends: [
    '@codoonfxd/commitlint-config'
  ]
};

或者使用 .commitlintrc.json 配置文件的方式:

{
  "extends": [
    "@codoonfxd/commitlint-config"
  ]
}

这样配置后,commitlint 将使用 @codoonfxd/commitlint-config 提供的规则来检查您的 Commit Message 。

接下来,我们可以尝试提交以下规范化的 Commit Message :

feat: add new feature

如果您的 Commit Message 不满足规范化格式,commitlint 将会提示以下错误信息:

❌  failed with commit message: 'my commit message'
  input: my commit message
  → type must not be empty [type-empty]
  ✖  found 1 problems, 0 warnings

配置规则

@codoonfxd/commitlint-config 配置了一组优秀的规则,让我们可以根据自己的需求来快速使用。

下面是 @codoonfxd/commitlint-config 中默认包含的规则:

type-enum

规则 type-enum 要求 Commit Message 中必须包含 type 字段,并且必须满足一组特定的规范化类型。

默认配置如下:

{
  rules: {
    // type 规范化
    "type-enum": [2, "always", [
      "feat", "fix", "docs", "style", "refactor", "test", "chore", "revert"
    ]],
  },
}

其中,type 字段对应的类型包括:

  • feat:新功能;
  • fix:修复问题;
  • docs:修改文档;
  • style:修改代码风格,不影响代码功能;
  • refactor:重构代码;
  • test:添加或修改测试用例;
  • chore:更新一些辅助工具的代码或配置文件等;
  • revert:回滚历史版本。

开发者可以根据自己的需求来修改 type-enum 规则中的类型。

subject-case

规则 subject-case 要求 Commit Message 中 subject 部分必须符合特定的格式要求。

默认配置如下:

{
  rules: {
    // subject 规范化
    "subject-case": [2, "always", "sentence-case"],
  },
}

其中,subject 部分的格式要求为以大写字母开头的句子格式。

subject-max-length

规则 subject-max-length 要求 Commit Message 中 subject 部分的长度不能超过一定的字符数。

默认配置如下:

{
  rules: {
    // subject 最大长度
    "subject-max-length": [2, "always", 50],
  },
}

其中,subject 部分的最大长度为 50 个字符。

以上是 @codoonfxd/commitlint-config 中默认包含的规则。如果开发者需要增加、替换或者修改这些规则,只需要在 commitlint.config.js 中进行更新即可。

总结

本文介绍了 @codoonfxd/commitlint-config 库的安装和配置方法,以及默认规则的介绍和使用方法。

@codoonfxd/commitlint-config 库能够帮助我们规范化 Commit Message 的格式,提升版本控制质量和效率。但在实际应用中,开发者还应该根据具体项目需求,自定义和更新规则。

来源:JavaScript中文网 ,转载请注明来源 本文地址:https://www.javascriptcn.com/post/600673e2fb81d47349e53db4


纠错
反馈