Git hook 怎么在提交前自动运行代码检查？

Question

仓乃文 · Accepted Answer

团队开发中经常有人提交忘记 lint 或格式化的代码，代码审查时才发现问题。Git hook 可以在特定操作（如 commit、push）前自动执行脚本，pre-commit 钩子可以在提交前运行代码检查，不通过则阻止提交。

手动创建 pre-commit 钩子：
```bash
# 创建钩子文件
touch .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit
```

钩子脚本示例：
```bash
#!/bin/sh
# .git/hooks/pre-commit

# 运行 ESLint 检查暂存区的 JS 文件
FILES=$(git diff --cached --name-only --diff-filter=ACM | grep "\.js$")
if [ -n "$FILES" ]; then
  npx eslint $FILES
  if [ $? -ne 0 ]; then
    echo "ESLint 检查未通过，请修复后再提交"
    exit 1  # 非零退出码阻止提交
  fi
fi
```

使用 husky 管理钩子（推荐）：
```bash
npm install husky --save-dev
npx husky init
echo "npx eslint --fix" > .husky/pre-commit
```

补充说明：
- .git/hooks 中的钩子不会被 Git 跟踪，无法共享给团队
- husky 将钩子放在项目目录中，可以提交到仓库共享
- --no-verify 可以跳过钩子：git commit --no-verify
- 常用钩子：pre-commit（提交前）、commit-msg（提交信息校验）、pre-push（推送前）
- 钩子脚本返回非零退出码会阻止对应操作