commitlint.config.mjs

// commitlint.config.mjs — Conventional Commits 规范配置
// 文档: https://commitlint.js.org
export default {
  extends: ['@commitlint/config-conventional'],
  rules: {
    // 允许的提交类型
    'type-enum': [
      2,
      'always',
      [
        'feat',      // 新功能
        'fix',       // Bug 修复
        'docs',      // 文档变更
        'style',     // 格式（不影响逻辑）
        'refactor',  // 重构（既非 feat 也非 fix）
        'perf',      // 性能优化
        'test',      // 添加/修改测试
        'chore',     // 构建过程或辅助工具变动
        'ci',        // CI 配置变更
        'revert',    // 回滚
        'build',     // 影响构建系统的变更
        'security',  // 安全修复（项目自定义）
        'release',   // 版本发布、打包、发布 changelog（项目自定义）
        'deps',      // 依赖升级 / 降级（比 chore: bump 语义更清晰）
        'i18n',      // 国际化 / 本地化文案变更
        'ux',        // UX / 交互改进（不引入新功能，区别于 feat）
      ],
    ],
    // subject 最大长度（允许中文描述）
    'subject-max-length': [2, 'always', 300],
    // header（type + scope + subject）整体最大长度同步放宽
    'header-max-length': [2, 'always', 300],
    // 不强制 subject 大小写，兼容中文提交信息
    'subject-case': [0],
    // body 每行最大长度宽松设置
    'body-max-line-length': [1, 'always', 200],
    // footer 每行最大长度同样放宽：当 body 段出现 "Closes #xx" / "BREAKING CHANGE:"
    // 等关键字时，conventional-commits-parser 会把其后整段当作 footer，默认 100 字符
    // 上限过于苛刻，且与 body 规则不一致，这里对齐到 200 / warn。
    'footer-max-line-length': [1, 'always', 200],
  },
};