如何用 commitlint 和 husky 规范代码提交？实战经验分享有哪些？

在团队协作开发中，杂乱的Git提交信息会导致代码历史难以追溯、版本回退困难等问题。Commitlint和Husky的组合能有效解决这一痛点——Commitlint负责校验提交信息格式，Husky通过Git钩子在提交时自动触发校验规则，强制开发者遵守规范。本文将手把手演示如何配置这两个工具，并分享实战中积累的高效经验。

一、快速搭建规范环境

1. 安装Husky（版本8.0+）

推荐使用Husky 8.0以上版本，新版采用更简洁的配置方式：
```bash
npm install husky --save-dev
npx husky install
```

2. 配置Commitlint校验规则

安装官方推荐配置包：
```bash
npm install @commitlint/cli @commitlint/config-conventional --save-dev
```

创建.commitlintrc.js文件：
```javascript
module.exports = {
extends: ['@commitlint/config-conventional'],
rules: {
'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore']]
}
};
```

3. 绑定Git钩子

添加commit-msg钩子：
```bash
npx husky add .husky/commit-msg 'npx --no commitlint --edit "$1"'
```

二、核心配置实战技巧

1. 自定义提交类型规范

在.commitlintrc.js中可扩展规则：
```javascript
rules: {
'type-case': [2, 'always', 'lower-case'], // 类型必须小写
'subject-max-length': [2, 'always', 72] // 描述不超过72字符
}
```

2. 智能提示提交格式

安装commitizen提供交互式提交：
```bash
npm install commitizen -g
commitizen init cz-conventional-changelog --save-dev --save-exact
```

3. 结合lint-staged使用

在package.json中添加：
```json
"lint-staged": {
".{js,ts}": "eslint --fix"
}
```

配置pre-commit钩子：
```bash
npx husky add .husky/pre-commit 'npx lint-staged'
```

三、避坑指南与最佳实践

1. 常见问题解决

问题1：钩子未生效
检查.git/hooks目录权限
重新执行npx husky install

问题2：配置更新不生效
删除.husky目录后重新安装
检查IDE的Git集成是否覆盖本地配置

2. 团队协作建议

将.husky目录提交到版本控制
在package.json的scripts中添加：
```json
"prepare": "husky install"
```
确保新成员npm install后自动初始化钩子

3. 提交信息优化模板

遵循Angular提交规范：
```
():
// 空行

// 空行