:sparkles:@2030/commitlint-config

代码提交规则标准规范

:fire:风格说明

• 标题不能为空且不得超过200个字符
• Scope可选
• 规范标准提交类型
• 默认提交类型

  [
    'init',               // 初次提交
    'work',               // 工作进行中
    'feat',               // 添加新功能
    'fix',                // 修复BUG
    'typos',              // 修改错别字
    'style',              // 改进项目结构/代码格式
    'docs',               // 添加/更新文档
    'config',             // 添加/修改配置文件
    'comments',           // 添加/更新注释
    'rename',             // 移动/重命名文件/路径
    'chore',              // 添加/删除代码/文件
    'perf',               // 优化性能
    'log',                // 添加/更新日志
    'refactor',           // 重构代码
    'test',               // 添加/修改测试用例
    'build',              // 构建/部署流程
    'release',            // 发布新版本
    'i18n',               // 国际化
    'revert',             // 回滚提交
    'merge',              // 合并分支
    'contributor',        // 添加贡献者
    'types',              // 类型声明或修改
    'ci',                 // 持续集成
  ]

:bulb:使用说明

1. 安装

• npm 安装:

  > npm i -D @commitlint/cli @2030/commitlint-config

• yarn 安装:

  > yarn add -D @commitlint/cli @2030/commitlint-config

• pnpm 安装:

  > pnpm add -D @commitlint/cli @2030/commitlint-config

2. 项目根目录配置

• @2030 基本规则
• @2030/commitlint-config-emoji 强制使用emoji规则

• .commitlintrc.json 配置:

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

• .commitlintrc.yml 配置:

  extends: "@2030/commitlint-config"

• .commitlintrc.js 配置:

  module.exports = {
    extends: ["@2030/commitlint-config"]
  }

3. 添加校验钩子

• Husky(V9+ 支持)

  # husky初始化
  pnpm add husky -D
  pnpm exec husky init

  • 添加 commit-msg 钩子

    echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg

• simple-git-hooks

  # 添加simple-git-hooks依赖
  pnpm add simple-git-hooks -D

  • 添加 package.json中prepare 脚本

  {
    "scripts": {
      "prepare": "simple-git-hooks"
    }
  }

  • 添加 package.json 钩子

  {
    "simple-git-hooks": {
      "commit-msg": "pnpm commitlint --edit $1",
    }
  }

:key:License

MIT License © 2026 ZiJun