Cómo Deshacer Errores de Git de Forma Segura: Revert, Reset y Checkout Explicados

Los errores de Git suelen sentirse peor de lo que realmente son. Puede que hayas commiteado el archivo incorrecto, añadido demasiados cambios al área de staging, o enviado un cambio incorrecto a una rama compartida. La solución segura depende de una pregunta: ¿el cambio ya ha sido compartido?

Esta guía explica cuándo usar git revert, git reset y git checkout, con ejemplos que puedes copiar con cuidado. La versión corta es simple: usa git revert para commits compartidos, git reset para limpieza local, y git checkout solo cuando quieras cambiar de rama o restaurar estados antiguos de archivos.

Primero, Verifica lo que Estás a Punto de Deshacer

Antes de ejecutar cualquier comando para deshacer, revisa tu estado actual:

git status
git log --oneline --decorate -5

git status te indica si tienes trabajo sin staging, en staging o sin seguimiento. git log muestra los commits recientes y hacia dónde apunta tu rama.

Si tienes trabajo local que no quieres perder, crea primero una rama de seguridad rápida:

git branch backup-antes-de-deshacer

Esa rama te da una forma fácil de volver atrás si eliges el comando incorrecto.

Usa git revert para Commits Ya Enviados (Pushed)

git revert crea un nuevo commit que aplica lo opuesto a un commit anterior. No elimina el historial, por lo que es la opción más segura para ramas compartidas como main, develop o cualquier rama que otras personas puedan haber descargado (pulled).

Supongamos que tu historial se ve así:

A -- B -- C -- D  main

El commit C introdujo un error, pero D es bueno y debe permanecer. Encuentra el hash del commit:

git log --oneline

Luego revierte solo ese commit:

git revert abcdef1

Git abre tu editor para el mensaje del commit de reversión. Después de guardarlo, el historial se ve así:

A -- B -- C -- D -- E  main

El commit E deshace los cambios de C. Todos pueden descargar (pull) ese nuevo commit normalmente.

Revirtiendo un Commit de Fusión (Merge Commit)

Los commits de fusión necesitan una bandera extra porque Git debe saber cuál es la línea principal (parent):

git revert -m 1 <hash-del-commit-de-fusion>

Para una fusión normal en main, -m 1 generalmente significa "mantener el primer padre", que es la rama en la que fusionaste. No adivines aquí. Ejecuta esto primero e inspecciona los padres:

git show --summary <hash-del-commit-de-fusion>

Si no estás seguro de qué padre mantener, pregunta a un compañero de equipo o prueba la reversión en una rama temporal.

Usa git reset para Commits Locales

git reset mueve el puntero de tu rama actual. Dependiendo del modo, también puede cambiar el área de staging y tus archivos de trabajo. Úsalo principalmente para commits que no hayas enviado (pushed).

Quitar un Archivo del Área de Staging

Si añadiste el archivo incorrecto al staging, quítalo sin cambiar el contenido del archivo:

git restore --staged archivo_no_deseado.txt

Ejemplos antiguos de Git a menudo usan este comando equivalente:

git reset HEAD archivo_no_deseado.txt

Ambos eliminan el archivo del área de staging. Tus ediciones permanecen en tu directorio de trabajo.

Deshacer el Último Commit pero Mantener los Cambios en Staging

Usa --soft cuando el mensaje del commit fue incorrecto o quieras añadir un archivo más antes de volver a committear:

git reset --soft HEAD~1

Tu rama retrocede un commit, pero los cambios de ese commit permanecen en el área de staging.

Deshacer el Último Commit y Mantener los Cambios Fuera del Staging

Usa el reset mixto por defecto cuando quieras reelaborar los archivos antes de committear de nuevo:

git reset HEAD~1

Esto mueve la rama un commit atrás y deja los cambios en tu directorio de trabajo.

Descartar Commits Locales y Cambios en Archivos

--hard restablece la rama, el área de staging y los archivos con seguimiento en tu directorio de trabajo:

git reset --hard HEAD~1

Usa esto solo cuando estés seguro de que no necesitas los cambios descartados. No elimina archivos sin seguimiento, pero descartará las ediciones de archivos con seguimiento sin preguntar de nuevo.

Usa git checkout con Cuidado

git checkout tiene dos trabajos comunes en flujos de trabajo antiguos de Git: cambiar de rama y restaurar archivos. Las versiones más nuevas de Git dividen esos trabajos en comandos más claros: git switch para ramas y git restore para archivos.

Para cambiar de rama:

git switch main

Equivalente antiguo:

git checkout main

Para descartar cambios no commiteados en un archivo con seguimiento:

git restore mi_archivo.txt

Equivalente antiguo:

git checkout -- mi_archivo.txt

Esa restauración de archivo es destructiva para las ediciones no commiteadas en el archivo seleccionado. Si puedes necesitar las ediciones más tarde, guárdalas (stash) primero:

git stash push -m "guardar trabajo antes de restaurar"

Usa git reflog Si Te Fuiste Demasiado Lejos

Si ejecutaste git reset --hard o moviste una rama por error, git reflog aún puede mostrar hacia dónde apuntaba HEAD:

git reflog

Podrías ver una entrada anterior como HEAD@{2} o un hash de commit de antes del reset. Puedes crear una rama de recuperación a partir de él:

git branch recuperacion <hash-del-commit>

Reflog es local para tu clon y no es un sistema de respaldo, pero a menudo te salva de errores recientes.

¿Qué Comando Deberías Elegir?

Usa git revert cuando el commit incorrecto ya haya sido enviado (pushed) u otras personas puedan haber basado su trabajo en él.

Usa git reset --soft cuando tu último commit local deba rehacerse pero los cambios aún sean correctos.

Usa git reset cuando quieras que el último commit local vuelva como cambios de archivo sin staging.

Usa git reset --hard solo cuando los cambios locales con seguimiento puedan eliminarse.

Usa git restore o git checkout -- <archivo> cuando quieras descartar cambios no commiteados en archivos específicos.

El hábito más seguro es verificar git status, crear una rama de respaldo temporal cuando haya mucho en juego y evitar reescribir el historial compartido. Si un commit ha llegado a un remoto compartido, git revert suele ser la solución más limpia.