Husky 如何配置 Git Hooks？

Question

仓乃文 · Accepted Answer

Husky 简化 Git Hooks 的配置管理，通常配合 lint-staged 只对暂存文件执行检查，避免全量扫描。

安装和初始化（Husky v9）：
```bash
npm install -D husky lint-staged
npx husky init  # 创建 .husky/ 目录和 pre-commit hook
```

配置 pre-commit hook：
```bash
# .husky/pre-commit
npx lint-staged
```

配置 lint-staged（只检查暂存文件）：
```json
// package.json
{
  "lint-staged": {
    "*.{js,jsx,ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{css,scss,less}": [
      "stylelint --fix",
      "prettier --write"
    ],
    "*.{json,md,yaml}": [
      "prettier --write"
    ]
  }
}
```

配置 commit-msg hook（校验提交信息）：
```bash
# .husky/commit-msg
npx --no -- commitlint --edit $1
```

```javascript
// commitlint.config.js
module.exports = {
  extends: ["@commitlint/config-conventional"],
  rules: {
    "type-enum": [2, "always", [
      "feat", "fix", "docs", "style", "refactor",
      "perf", "test", "chore", "ci", "build",
    ]],
  },
};
```

补充说明：
- Husky v9 使用 .husky/ 目录管理 hooks，不再依赖 package.json
- lint-staged 只检查 git add 的文件，大幅提升速度
- commitlint 强制统一的提交信息格式，方便生成 changelog
- 可以用 npm run test:coverage 在 pre-push 时检查测试覆盖率