O que são Git hooks e como são usados?

Question

Accepted Answer

**Git hooks** são scripts que Git executa **automaticamente** em certos pontos do fluxo de trabalho do Git (antes/depois de commits, pushes, merges, etc.). Eles permitem automação — impondo padrões, executando verificações e acionando ações — e são amplamente utilizados para qualidade de código e integração com CI.

## O que são 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
```

## Usos comuns

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

## Gerenciando hooks em equipe

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

## Por que isso importa

Compreender Git hooks é conhecimento valioso de nível sênior para **automatizar verificações de qualidade e ações de fluxo de trabalho**, portanto é útil para manter a qualidade do código e integrar com CI/CD.

Hooks permitem **automação em eventos-chave do Git** — executando scripts automaticamente antes/depois de commits, pushes, merges, etc. — que é amplamente utilizado para impor padrões e detectar problemas cedo.

O uso mais comum e valioso é o **pre-commit hook** para executar **linting, formatação, testes rápidos e detecção de segredos antes do código ser commitado** — fornecendo feedback rápido e garantindo qualidade consistente automaticamente (para que problemas sejam detectados no momento do commit em vez de mais tarde em CI ou revisão), uma prática extremamente popular.

Outros usos (hooks commit-msg impondo convenções de mensagem como Conventional Commits, hooks pre-push executando testes para evitar enviar código quebrado, e hooks do lado do servidor impondo políticas ou acionando CI/CD e deployments) estendem a automação pelo fluxo de trabalho.

Entender o aspecto prático de **gerenciamento em equipe** é importante: `.git/hooks/` é local e **não é commitado**, então hooks não são compartilhados automaticamente — compartilhá-los entre a equipe requer ferramentas como **Husky, pre-commit ou lefthook** que versionam hooks no repositório e os instalam para todos.

Crucialmente, entender que hooks **podem ser contornados** (`--no-verify`) significa que eles fornecem feedback rápido *local* mas **CI também deve impor** as verificações como a verdadeira rede de segurança — uma percepção chave sobre defesa em profundidade (hooks locais para velocidade, CI para execução).

Como automatizar verificações de qualidade e ações de fluxo de trabalho melhora a qualidade e consistência do código, e como Git hooks (especialmente pre-commit para verificações locais, gerenciados via ferramentas e complementados por CI) são um mecanismo amplamente utilizado para isso, compreender Git hooks — o que são, usos comuns, gerenciamento em equipe com ferramentas e sua relação com CI — é conhecimento valioso de nível sênior para construir fluxos de trabalho de desenvolvimento automatizados e focados em qualidade, refletindo as práticas usadas para manter qualidade em equipes profissionais.