¿Qué son los Git hooks y cómo se utilizan?

Question

Accepted Answer

**Git hooks** son scripts que Git ejecuta **automáticamente** en ciertos puntos del flujo de trabajo de Git (antes/después de commits, pushes, merges, etc.). Permiten la automatización — aplicar estándares, ejecutar verificaciones y desencadenar acciones — y se utilizan ampliamente para la calidad del código e integración con CI.

## Qué son los 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 comunes

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

## Gestión de hooks en un equipo

```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 qué es importante

Comprender Git hooks es conocimiento valioso a nivel senior para **automatizar verificaciones de calidad y acciones de flujo de trabajo**, por lo que es útil para mantener la calidad del código e integración con CI/CD.

Los hooks permiten **automatización en eventos clave de Git** — ejecutar scripts automáticamente antes/después de commits, pushes, merges, etc. — lo cual se utiliza ampliamente para aplicar estándares y detectar problemas temprano.

El uso más común y valioso es el **hook pre-commit** para ejecutar **linting, formateo, pruebas rápidas y detección de secretos antes de que el código se confirme** — proporcionar retroalimentación rápida y garantizar calidad consistente automáticamente (para que los problemas se detecten en el momento del commit en lugar de más tarde en CI o revisión), una práctica enormemente popular.

Otros usos (hooks commit-msg que aplican convenciones de mensajes como Conventional Commits, hooks pre-push que ejecutan pruebas para evitar hacer push de código roto, y hooks del lado del servidor que aplican políticas o desencadenan CI/CD y despliegues) extienden la automatización a lo largo del flujo de trabajo.

Comprender el aspecto práctico de **gestión en equipo** es importante: `.git/hooks/` es local y **no se confirma**, por lo que los hooks no se comparten automáticamente — compartirlos en un equipo requiere herramientas como **Husky, pre-commit o lefthook** que versionan hooks en el repositorio e los instalan para todos.

Crucialmente, comprender que los hooks **pueden ser omitidos** (`--no-verify`) significa que proporcionan retroalimentación rápida *local* pero **CI también debe aplicar** las verificaciones como la red de seguridad real — una idea clave sobre defensa en profundidad (hooks locales para velocidad, CI para aplicación).

Ya que automatizar verificaciones de calidad y acciones de flujo de trabajo mejora la calidad y consistencia del código, y ya que Git hooks (especialmente pre-commit para verificaciones locales, gestionados mediante herramientas y complementados por CI) son un mecanismo ampliamente utilizado para esto, comprender Git hooks — qué son, usos comunes, gestión en equipo con herramientas y su relación con CI — es conocimiento valioso a nivel senior para construir flujos de trabajo de desarrollo automatizados y enfocados en calidad, reflejando las prácticas utilizadas para mantener calidad en equipos profesionales.