Git hookとは何で、どのように使われますか?

Question

Accepted Answer

**Git hook**は、Gitワークフローの特定の時点(commit、push、mergeなどの前後)でGitが**自動的に**実行するスクリプトです。これらは標準の強制、チェックの実行、アクションのトリガーといった自動化を可能にし、コード品質やCI連携に広く使われています。

## hookとは何か

```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
```

## チームでのhookの管理

```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 hookを理解することは、**品質チェックやワークフローのアクションを自動化する**ためのシニアレベルの価値ある知識であり、コード品質の維持やCI/CDとの連携に役立ちます。

hookは**Gitの重要なイベントでの自動化**を可能にします。commit、push、mergeなどの前後でスクリプトを自動的に実行するもので、標準を強制し問題を早期に発見するために広く使われています。

最も一般的で価値のある用途は、**コードがcommitされる前にlint、フォーマット、簡単なテスト、シークレット検出を実行する**ための**pre-commit hook**です。これは速いフィードバックを提供し、一貫した品質を自動的に保証します(問題がCIやレビューの後ではなくcommit時に発見される)。これは非常に普及した実践です。

その他の用途(Conventional Commitsのようなメッセージ規約を強制するcommit-msg hook、壊れたコードのpushを防ぐためテストを実行するpre-push hook、ポリシーを強制したりCI/CDやデプロイをトリガーするサーバーサイドhook)は、自動化をワークフロー全体に広げます。

実践的な**チーム管理**の側面を理解することは重要です。`.git/hooks/`はローカルであり**commitされない**ため、hookは自動的に共有されません。チーム全体で共有するには、リポジトリ内でhookをバージョン管理し全員にインストールする**Husky、pre-commit、lefthook**のようなツールが必要です。

決定的に重要なのは、hookが**バイパスできる**(`--no-verify`)ことを理解することです。これはhookが速い*ローカル*フィードバックを提供する一方で、**CIもまたチェックを強制**しなければならない真の安全網であることを意味します。これは多層防御に関する重要な洞察です(速さのためのローカルhook、強制のためのCI)。

品質チェックとワークフローのアクションを自動化することはコード品質と一貫性を向上させ、Git hook(特にローカルチェックのためのpre-commit、ツールで管理されCIで補完される)はそのための広く使われる仕組みです。そのため、Git hook(その正体、よくある用途、ツールでのチーム管理、CIとの関係)を理解することは、自動化された品質重視の開発ワークフローを構築するためのシニアレベルの価値ある知識であり、プロフェッショナルなチームで品質を維持するために使われる実践を反映しています。