:sparkles:@2030/commitlint-config-emoji

代码提交规则标准规范

:fire:风格说明

• 标题不能为空且不得超过108个字符
• 可选Scope
• 规范标准提交类型
• 可配合插件 seatonjiang.gitmoji-vscode 使用
• 默认提交类型

  [
    '🎉 init',           // 初次提交
    '🚧 work',           // 工作进行中
    '👔 work',           // 添加/更新业务逻辑
    '✨ feat',           // 添加新功能
    '💥 feat',           // 引入重大改变
    '🐛 fix',            // 修复BUG
    '🩹 fix',            // 简单修复非关键性问题
    '🚑 fix',            // 紧急热修复
    '🔒️ fix',            // 修复安全/隐私问题
    '🚨 fix',            // 修复编译错误/警告
    '✏️ typos',          // 修复拼写错误/错别字
    '💄 style',          // 添加/更新UI样式文件
    '🎨 style',          // 改进项目结构/代码格式
    '📝 docs',           // 添加/更新文档
    '🔧 config',         // 添加/修改配置文件
    '💡 comment',        // 添加/更新注释
    '🚚 rename',         // 移动/重命名文件/路径
    '🔥 chore',          // 添加/删除代码/文件
    '📌 chore',          // 固定依赖版本
    '➕ chore',          // 添加依赖
    '➖ chore',          // 删除依赖
    '⬆️ chore',           // 升级依赖
    '⬇️ chore',           // 降级依赖
    '⚡️ perf',           // 优化性能
    '🗑️ perf',           // 删除无用代码
    '🔊 log',            // 添加/更新日志
    '🔇 log',            // 删除日志
    '♻️ refactor',       // 重构代码
    '🧪 test',           // 添加/修改测试用例
    '🦺 test',           // 添加/更新验证相关代码
    '🚀 build',          // 构建/部署功能
    '🔖 release',        // 发行版本标签
    '🌐 i18n',            // 国际化
    '⏪ revert',         // 回滚提交
    '🔀 merge',          // 合并分支
    '👥 contributor',    // 添加/更新贡献者
    '🏷️ types',          // 类型声明或修改
    '👷‍♂️ ci',             // 持续集成
  ]

:bulb:使用说明

1. 安装

• npm 安装:

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

• yarn 安装:

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

• pnpm 安装:

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

2. 项目根目录配置

• .commitlintrc.json 配置:

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

• .commitlintrc.yml 配置:

  extends: "@2030/commitlint-config-emoji"

• .commitlintrc.js 配置:

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

3. VScode配置

• 安装插件:

  > // 安装插件
  > code --install-extension seatonjiang.gitmoji-vscode

• 配置 settings.json 文件:

  {
    "gitmoji.addCustomEmoji": [
      {
        "description": "初次提交",
        "emoji": "🎉 init:"
      },
      {
        "description": "工作进行中",
        "emoji": "🚧 work:"
      },
      {
        "description": "添加/更新业务逻辑",
        "emoji": "👔 work:"
      },
      {
        "description": "添加新功能",
        "emoji": "✨ feat:"
      },
      {
        "description": "引入重大改变",
        "emoji": "💥 feat:"
      },
      {
        "description": "修复BUG",
        "emoji": "🐛 fix:"
      },
      {
        "description": "简单修复非关键性问题",
        "emoji": "🩹 fix:"
      },
      {
        "description": "紧急热修复",
        "emoji": "🚑 fix:"
      },
      {
        "description": "修复安全/隐私问题",
        "emoji": "🔒️ fix:"
      },
      {
        "description": "修复编译错误/警告",
        "emoji": "🚨 fix:"
      },
      {
        "description": "修复拼写错误/错别字",
        "emoji": "✏️ typos:"
      },
      {
        "description": "添加/更新UI样式文件",
        "emoji": "💄 style:"
      },
      {
        "description": "改进项目结构/代码格式",
        "emoji": "🎨 style:"
      },
      {
        "description": "添加/更新文档",
        "emoji": "📝 docs:"
      },
      {
        "description": "添加/修改配置文件",
        "emoji": "🔧 config:"
      },
      {
        "description": "添加/更新注释",
        "emoji": "💡 comment:"
      },
      {
        "description": "移动/重命名文件/路径",
        "emoji": "🚚 rename:"
      },
      {
        "description": "添加/删除代码/文件",
        "emoji": "🔥 chore:"
      },
      {
        "description": "固定依赖版本",
        "emoji": "📌 chore:"
      },
      {
        "description": "添加依赖",
        "emoji": "➕ chore:"
      },
      {
        "description": "删除依赖",
        "emoji": "➖ chore:"
      },
      {
        "description": "升级依赖",
        "emoji": "⬆️ chore:"
      },
      {
        "description": "降级依赖",
        "emoji": "⬇️ chore:"
      },
      {
        "description": "优化性能",
        "emoji": "⚡️ perf:"
      },
      {
        "description": "删除无用代码",
        "emoji": "🗑️ perf:"
      },
      {
        "description": "添加/更新日志",
        "emoji": "🔊 log:"
      },
      {
        "description": "删除日志",
        "emoji": "🔇 log:"
      },
      {
        "description": "重构代码",
        "emoji": "♻️ refactor:"
      },
      {
        "description": "添加/更新测试用例",
        "emoji": "🧪 test:"
      },
      {
        "description": "添加/更新验证相关代码",
        "emoji": "🦺 test:"
      },
      {
        "description": "构建/部署功能",
        "emoji": "🚀 build:"
      },
      {
        "description": "发行版本标签",
        "emoji": "🔖 release:"
      },
      {
        "description": "国际化",
        "emoji": "🌐 i18n:"
      },
      {
        "description": "回滚版本",
        "emoji": "⏪ revert:"
      },
      {
        "description": "合并分支",
        "emoji": "🔀 merge:"
      },
      {
        "description": "添加/更新贡献者",
        "emoji": "👥 contributor:"
      },
      {
        "description": "添加/更新类型声明文件",
        "emoji": "🏷️ types:"
      },
      {
        "description": "持续集成",
        "emoji": "👷‍♂️ ci:"
      }
    ],
  }

4. 添加 husky hook - commit-msg

Husky v9 代码示例:

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

• 添加 commit-msg 钩子

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

:key:License

MIT License © 2022 ZiJun