This article is only available in Spanish.
Deja de hacer commits desastrosos: usa git add -p
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 revertde 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 -pignora los archivos sin seguimiento. Márcalos antes congit add -N archivoy 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.