Saltar al contenido
jungladigital

Volver atrás: git restore y git revert

Lo que todavía no fotografiaste se descarta con git restore. Una foto mala no se arranca del álbum: se anula con otra foto, con git revert. La red de seguridad que te deja probar sin miedo, con un archivo roto a propósito.

El comando git restore en verde sobre fondo oscuro: volver atrás con git restore y git revert

Al cerrar el sendero de Claude Code te dije que la foto inicial era tu red de seguridad. Hasta hoy era una promesa: sabías sacar fotos y mirarlas, pero no volver a ellas. Esta parada la cumple. Hay dos casos, y en papel los conoces bien: el borrador y la corrección. Lo que escribiste en un borrador y no te gusta, lo tiras. Lo que ya entregaste no se arranca de la libreta: se corrige con una nota nueva que dice «donde dice esto, léase esto otro».

Este artículo se adapta a tu sistema

El borrador: git restore

Abre PROYECTO.md, borra casi todo, deja solo el título y guarda. Rompiste el archivo. Ahora:

Mac
~/barberia
$ git status --short M PROYECTO.md$ git diff --stat PROYECTO.md | 29 +---------------------------- 1 file changed, 1 insertion(+), 28 deletions(-)$ git restore PROYECTO.md$ git statusEn la rama masternada para hacer commit, el árbol de trabajo está limpio

Windows

~\barberia
$ git status --short M PROYECTO.md$ git diff --stat PROYECTO.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-)$ git restore PROYECTO.md$ git statusOn branch masternothing to commit, working tree clean

Abre el archivo de nuevo: está como en la última foto, completo.


git status --short es la versión de un renglón por archivo: la M quiere decir modificado. git diff --stat resume el daño sin mostrar cada renglón: casi todo el archivo, borrado. Y git restore PROYECTO.md tira el borrador y trae el archivo tal como estaba en la última foto. Tiene un costo, y conviene saberlo antes de usarlo: lo que descartas así no va a la Papelera. Si en ese archivo había algo bueno que nunca fotografiaste, se va con lo malo. Para eso sirve sacar fotos seguido. En tutoriales viejos vas a ver git checkout -- PROYECTO.md para lo mismo; funciona, pero git restore se entiende mejor.

Si ya estaba sobre la mesa

Rompes el archivo otra vez, pero ahora alcanzaste a hacer git add:

Mac
~/barberia
$ git add PROYECTO.md$ git statusEn la rama masterCambios a ser confirmados:  (usa "git restore --staged <archivo>..." para sacar del área de stage)	modificados:     PROYECTO.md$ git restore --staged PROYECTO.md$ git statusEn la rama masterCambios no rastreados para el commit:  (usa "git add <archivo>..." para actualizar lo que será confirmado)  (usa "git restore <archivo>..." para descartar los cambios en el directorio de trabajo)	modificados:     PROYECTO.mdsin cambios agregados al commit (usa "git add" y/o "git commit -a")$ git restore PROYECTO.md$ git status --short

Windows

~\barberia
$ git add PROYECTO.md$ git statusOn branch masterChanges to be committed:  (use "git restore --staged <file>..." to unstage)	modified:   PROYECTO.md$ git restore --staged PROYECTO.md$ git statusOn branch masterChanges not staged for commit:  (use "git add <file>..." to update what will be committed)  (use "git restore <file>..." to discard changes in working directory)	modified:   PROYECTO.mdno changes added to commit (use "git add" and/or "git commit -a")$ git restore PROYECTO.md$ git status --short

Dos pasos: bajarlo de la mesa y después tirar el borrador.


git restore --staged solo baja el archivo de la mesa; el cambio sigue en la carpeta. Por eso el segundo git status lo muestra otra vez fuera de la mesa. Solo el git restore sin --staged lo descarta. Que sean dos pasos es a propósito: sacar algo de la mesa es inofensivo, tirarlo no. Y no tienes que memorizar nada, porque git status te escribe en cada caso el comando que corresponde entre paréntesis. El último git status --short no imprime nada: la carpeta está igual que en la última foto.

La corrección: git revert

Supón que tu copiloto agregó una sección de ofertas y la fotografiaste sin leer el diff. El dueño de la barbería no quiere ofertas:

Mac
~/barberia
$ git revert HEAD --no-edit[master 7bf313e] Revert "ofertas de los martes" Date: Mon Nov 9 11:08:37 2026 -0500 1 file changed, 3 deletions(-)$ git log --oneline7bf313e (HEAD -> master) Revert "ofertas de los martes"9247f9d ofertas de los martes924a2a3 formas de pago en PROYECTO.md1d2939b sube el corte a 9 dólares208bb41 notas sueltas02d43a4 horario en PROYECTO.md19e9720 datos reales de la barberíacba69c9 proyecto descrito y archivos de manejo

Windows

~\barberia
$ git add PROYECTO.md# el mismo aviso de CRLF de antes, recortado$ git commit -m "ofertas de los martes"[master 3306428] ofertas de los martes 1 file changed, 3 insertions(+)$ git revert HEAD --no-edit[master f1543e5] Revert "ofertas de los martes" Date: Mon Nov 9 15:56:06 2026 +0000 1 file changed, 3 deletions(-)

Las ofertas ya no están en PROYECTO.md, y el álbum tiene una foto más.


HEAD es la foto en la que estás parado, la última. git revert HEAD saca una foto nueva que hace lo contrario de esa: borra los tres renglones que la otra agregó. La foto mala sigue en el álbum, y la corrección queda al lado con su nota, «Revert», que quiere decir revertir. Así la historia no miente: se ve qué pasó y cómo se arregló. Para anular una foto más vieja, en vez de HEAD usas su código corto, el que te da git log --oneline.

--no-edit le dice a git que use esa nota automática sin preguntarte. Sin él, git abre un editor dentro de la terminal, una pantalla con rayitas ~ a la izquierda; si alguna vez caes ahí, pulsa Esc, escribe :wq y Enter.

¿Y Time Machine o el Historial de archivos?

Siguen siendo buenos, y no los apagues. Time Machine en Mac o el Historial de archivos de Windows guardan copias solas, cada cierto tiempo, de tus carpetas personales: si se te muere la computadora, git no te salva, porque el álbum vive dentro de la misma carpeta. Donde git gana es en el control. Tú decides cuándo se saca cada foto y qué dice su nota, ves exactamente qué cambió entre dos fotos, y puedes anular un cambio puntual sin traer de vuelta todo lo demás. Con un agente de IA editando cinco archivos en un minuto, eso cuenta: si cada cambio tuvo su foto, anulas solo el que sobra.

La foto siempre estuvo ahí; ahora sabes volver. En la última parada, lo que nunca debe salir en una foto.