Что такое Git hooks и как их использовать?

Question

Accepted Answer

**Git hooks** — это скрипты, которые Git запускает **автоматически** в определённых точках 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** — запускать скрипты автоматически до/после коммитов, пушей, мержей и т.д. — что широко используется для проверки стандартов и выявления проблем на ранних стадиях.

Самое распространённое и ценное применение — **pre-commit hook** для запуска **linting, форматирования, быстрых тестов и детектирования секретов перед коммитом** — обеспечивает быструю обратную связь и гарантирует согласованное качество автоматически (проблемы выявляются при коммите, а не позже в CI или при ревью), это очень популярная практика.

Другие применения (commit-msg hooks для проверки соглашений о сообщениях коммитов, таких как Conventional Commits, pre-push hooks для запуска тестов перед пушем, и серверные hooks для проверки политик или триггеров CI/CD и развёртывания) расширяют автоматизацию на весь процесс.

Понимание практического аспекта **управления в команде** важно: `.git/hooks/` локален и **не коммитится**, поэтому hooks не распространяются автоматически — их распространение в команде требует инструментов вроде **Husky, pre-commit или lefthook**, которые версионируют hooks в репозитории и устанавливают их для всех.

Что критично важно понимать: hooks **можно обойти** (`--no-verify`), поэтому они обеспечивают быструю *локальную* обратную связь, но **CI должна также проверять** критерии как реальная подстраховка — это ключевой инсайт о многоуровневой защите (локальные hooks для скорости, CI для проверки).

Поскольку автоматизация проверок качества и действий в процессе улучшает качество и консистентность кода, и поскольку Git hooks (особенно pre-commit для локальных проверок, управляемые через инструменты и дополняемые CI) — широко используемый механизм для этого, понимание Git hooks — что это, распространённые применения, управление в команде с помощью инструментов и их связь с CI — это ценные знания для старшего уровня для построения автоматизированных, ориентированных на качество рабочих процессов разработки, отражающих практики, используемые для поддержания качества в профессиональных командах.