元素
元素
工具
博客
问答

commitlint 配置了 type-enum 为啥还是能提交不符合规范的 commit？

夏侯玉卿 阅读 56
前端

我按照文档配了 commitlint 的 type-enum，只允许 feat、fix、docs 这几种类型，但 git commit 时写了个 typo: xxx 还是成功提交了，根本没报错。是不是哪里没生效？

我用的是 husky + commitlint 的组合，配置文件如下：

module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [2, 'always', ['feat', 'fix', 'docs']]
  }
};
我来解答 赞 9 收藏
二维码
手机扫码查看
反馈
2 条解答
UP主～小菊
UP主～小菊 Lv1
问题很可能是 husky 的 commit-msg hook 没配置好。commitlint 本身配置对了，但如果 husky 没有在 commit-msg 时触发它，那就等于没配。

检查一下你有没有执行这两步：

第一步，初始化 husky：
npx husky install


第二步，添加 commit-msg hook：
npx husky add .husky/commit-msg 'npx --no -- commitlint --edit "$1"'


执行完第二步后，看看你的 .husky 目录下有没有 commit-msg 文件，内容大概是：
#!/usr/bin/env sh

. "$(dirname -- "$0")/_/husky.sh"

npx --no -- commitlint --edit "$1"


如果 hook 根本没建立，那 commitlint 根本不会被调用，你配置文件写得再对也没用。

另外提醒一下，如果你用的是 npm script 里手动调用 commitlint 除外，否则必须通过 husky 的 commit-msg hook 来拦截提交。
点赞
2026-03-11 22:07
司空馨冉
司空馨冉 Lv1
配置本身没毛病，问题大概率出在 husky 那边——commit-msg 钩子没挂上，commitlint 根本没跑起来。

先检查你的 .husky 目录下有没有 commit-msg 文件，没有的话需要手动创建。husky v6 之后的版本配置方式变了，不再往 package.json 里写配置了。

在项目根目录执行这两步：

npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'


或者手动在 .husky 目录下新建 commit-msg 文件，内容如下：

#!/usr/bin/env sh

. "$(dirname -- "$0")/_/husky.sh"



npx --no-install commitlint --edit $1


别忘了给这个文件加上执行权限：

chmod +x .husky/commit-msg


这样配置完，再试下 git commit，不合规的提交就会被拦截报错了。

另外吐槽一句，你的 rules 配置可以稍微优雅一点，把类型抽出来维护，后面加类型不用改两遍：

const types = ['feat', 'fix', 'docs'];



module.exports = {

  extends: ['@commitlint/config-conventional'],

  rules: {

    'type-enum': [2, 'always', types]

  }

};


这样后面如果想加 scope-enum 或者其他规则复用这个类型列表也方便。
点赞 4
2026-03-01 10:00
相关推荐
元素
元素
工具
博客
问答
登录/注册