Volver al blog

Deja de hacer commits desastrosos: usa git add -p

Serie: Git sin miedo

Arreglas un bug, de paso renombras una variable, dejas un console.log para depurar y haces git add .. Resultado: un commit que mezcla tres cosas, imposible de revisar e imposible de revertir sin llevarte lo demás por delante.

git add -p (de patch) te deja elegir qué trozos de cada archivo entran en el commit.

Cómo funciona

git add -p

Git te enseña los cambios por bloques (hunks) y te pregunta qué hacer con cada uno:

Tecla Qué hace
y añade este bloque
n no lo añade
s divide el bloque en otros más pequeños
e edita a mano qué líneas entran
q sale (lo ya elegido se queda preparado)
? muestra la ayuda

Puedes limitarlo a un archivo: git add -p src/auth.ts.

El flujo completo

git add -p                      # elige solo el arreglo del bug
git diff --staged               # revisa qué va al commit
git commit -m "Corrige el login con emails en mayúsculas"

git add -p                      # ahora el renombrado
git commit -m "Renombra usr a user en auth"

El console.log se queda sin añadir. Bórralo con git restore -p, que funciona igual pero para descartar bloques.

Si añadiste algo de más, git restore --staged -p lo saca del staging bloque a bloque.

Por qué merece la pena

  • Revisión más fácil: cada commit cuenta una sola historia.
  • Revertir sin miedo: git revert de un commit atómico deshace solo ese cambio.
  • Te obliga a releer tu diff antes de commitear, y ahí aparecen los restos de depuración.

Cuándo no te sirve

  • Archivos nuevos: git add -p ignora los archivos sin seguimiento. Márcalos antes con git add -N archivo y después ya puedes elegir sus bloques.
  • Archivos binarios: no se pueden dividir.
  • Reformateos masivos: si el formateador tocó todo el archivo, haz un commit solo de formato y otro con el cambio real.

Si se te coló algo y el commit ya está hecho en la rama equivocada, mira cómo moverlo.