Git hooks 是什么，如何使用它们？

Question

Accepted Answer

**Git hooks** 是 Git **自动**在工作流程中的某些特定点（提交前/后、推送、合并等）运行的脚本。它们启用自动化 — 强制执行标准、运行检查和触发操作 — 并广泛用于代码质量和 CI 集成。

## Hooks 是什么

```text
Hooks are executable scripts in .git/hooks/ (or managed by tools) that Git runs on EVENTS:
  CLIENT-SIDE (local):
    pre-commit   → before a commit is created (lint, format, run quick tests)
    commit-msg   → validate/format the commit message
    pre-push     → before pushing (run tests, prevent pushing broken code)
    post-merge/checkout → after merge/checkout (e.g. reinstall dependencies)
  SERVER-SIDE (on the remote):
    pre-receive / update → enforce policies on push (reject bad pushes)
    post-receive → trigger deployment/CI/notifications after a push
```

## 常见用途

```text
✓ pre-commit → LINT and FORMAT code; run quick tests; block secrets/debug code
  → catch issues BEFORE they're committed (fast feedback, consistent quality)
✓ commit-msg → enforce message format (e.g. Conventional Commits)
✓ pre-push → run the test suite → don't push failing code
✓ server-side → enforce policies; trigger CI/CD and deployments
```

## 在团队中管理 hooks

```text
⚠️ .git/hooks/ is LOCAL and NOT committed → hooks aren't shared automatically.
To share hooks across a team, use tools:
  → HUSKY (JS ecosystem), pre-commit (Python framework), lefthook, etc.
  → these version hooks in the repo and install them for everyone
→ Combined with CI: hooks give FAST LOCAL feedback; CI is the enforced safety net
  (hooks can be bypassed with --no-verify, so CI must also enforce).
```

## 为什么这很重要

理解 Git hooks 对于**自动化质量检查和工作流程操作**是有价值的高级知识，因此对于维持代码质量和与 CI/CD 集成很有用。

Hooks 在关键 Git 事件处启用**自动化** — 在提交、推送、合并等前/后自动运行脚本 — 这广泛用于强制执行标准和及早发现问题。

最常见和最有价值的用途是**预提交 hook**，用于在代码被提交前运行**代码检查、格式化、快速测试和密钥检测** — 提供快速反馈并自动确保一致的质量（以便在提交时而不是之后在 CI 或审查中捕获问题），这是一个非常流行的做法。

其他用途（提交消息 hooks 强制执行消息约定如 Conventional Commits、预推送 hooks 运行测试以防止推送损坏的代码，以及服务器端 hooks 强制执行策略或触发 CI/CD 和部署）在工作流程中扩展自动化。

理解实际的**团队管理**方面很重要：`.git/hooks/` 是本地的，**不被提交**，所以 hooks 不会自动共享 — 在团队中共享它们需要像 **Husky、pre-commit 或 lefthook** 这样的工具，这些工具在仓库中对 hooks 进行版本控制并为所有人安装它们。

至关重要的是，理解 hooks **可以被绕过**（`--no-verify`）意味着它们提供快速*本地*反馈，但 **CI 也必须强制执行**这些检查作为真正的安全网 — 这是关于纵深防御的关键见解（本地 hooks 用于速度，CI 用于强制执行）。

由于自动化质量检查和工作流程操作提高了代码质量和一致性，而且由于 Git hooks（特别是用于本地检查的预提交 hook、通过工具管理并由 CI 补充）是广泛使用的机制，理解 Git hooks — 它们是什么、常见用途、使用工具进行团队管理以及它们与 CI 的关系 — 对于构建自动化、质量导向的开发工作流程是有价值的高级知识，反映了用于在专业团队中维持质量的实践。