HOWTO · Git

Cómo usar `git reset --soft`

Aprende a usar `git reset --soft` para mover una rama a un commit anterior y conservar los cambios preparados. Después, verifica el contenido preparado y continúa el trabajo con seguridad.

En esta página

Usa git reset --soft <target> para mover la punta de la rama actual a un commit anterior sin modificar el índice ni el árbol de trabajo. Por tanto, los cambios introducidos por los commits que dejas atrás siguen preparados, listos para revisarlos y volver a confirmarlos. Esto resulta útil si quieres combinar commits recientes o cambiar sus mensajes sin perder su contenido.

Qué cambia git reset --soft

Un restablecimiento suave cambia HEAD y la punta de la rama actual al commit que indiques. No actualiza el índice de preparación ni los archivos del árbol de trabajo. Como resultado, los cambios entre la punta anterior y el destino quedan preparados con respecto a la nueva punta. El comando afecta a la rama que tienes activa; no mueve todas las ramas que apuntan al commit anterior.

Indica siempre un destino cuando quieras mover el historial. Si lo omites, Git usa HEAD, por lo que la rama no se mueve. El trabajo que ya estaba preparado o sin preparar también permanece intacto. Después, revisa las diferencias preparadas para saber exactamente qué incluirá un commit posterior.

Elige el commit al que quieres restablecer

Consulta el historial reciente con git log --oneline. Elige el commit que debería convertirse en la punta de la rama actual y confirma su asunto o hash antes de ejecutar el restablecimiento. Por ejemplo, HEAD~1 representa el primer padre del commit actual; selecciona el commit anterior en la línea de historial actual. HEAD~2 retrocede dos pasos siguiendo el primer padre. También puedes indicar una rama con nombre, una etiqueta o el hash de un commit.

El destino es el commit que quieres conservar como punta, no el commit que quieres quitar. Al restablecer a HEAD~1, la rama retrocede un commit y los cambios de la punta anterior quedan preparados. Si el historial no es lineal, comprueba el destino en el registro en lugar de suponer que una expresión con un número de padre selecciona el commit que tienes en mente.

Restablece commits y conserva los cambios preparados

Para restablecer un solo commit, primero consulta el historial y luego ejecuta git reset --soft HEAD~1. Para combinar varios commits recientes, usa el destino anterior que corresponda, como git reset --soft HEAD~3. El índice y el árbol de trabajo se conservan, así que los cambios de esos commits quedan disponibles juntos para crear un nuevo commit.

Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
git config user.name "Example User"
git config user.email "example@example.com"
printf 'first version\n' > note.txt
git add note.txt
git commit -qm "Add note"
printf 'second version\n' > note.txt
git commit -qam "Update note"
git reset --soft HEAD~1
git status --short

El ejemplo termina correctamente y muestra M note.txt, lo que confirma que el cambio sigue preparado después del restablecimiento suave.

Verifica los cambios preparados

Después del restablecimiento, usa git status para confirmar que los archivos previstos están preparados. Usa git diff --cached para revisar el parche preparado exacto antes de crear otro commit. La opción --cached compara el índice con HEAD, que ahora es el destino seleccionado. Si los cambios mostrados no son los que esperabas, detente y revisa el destino y las diferencias antes de confirmar.

Cuando el parche preparado sea correcto, crea un commit de reemplazo con git commit -m "Describe the combined change". Para actualizar el commit más reciente en su lugar, git commit --amend lo reemplaza; revisa cuidadosamente el contenido preparado y el mensaje del commit antes de confirmar. Un restablecimiento suave no crea automáticamente un commit ni cambia los mensajes de los commits.

Cómo se compara --soft con --mixed y --hard

Los tres modos de restablecimiento mueven la punta de la rama actual al destino, pero gestionan de forma distinta el índice y el árbol de trabajo:

  • git reset --soft <target> mueve la punta de la rama y deja intactos tanto el índice como el árbol de trabajo. Los cambios confirmados afectados siguen preparados.
  • git reset --mixed <target> mueve la punta de la rama y actualiza el índice para que coincida con el destino, pero deja intactos los archivos del árbol de trabajo. Los cambios de los commits que dejas atrás pasan a no estar preparados. --mixed es el modo predeterminado cuando no se especifica ninguno.
  • git reset --hard <target> mueve la punta de la rama y hace que tanto el índice como los archivos versionados del árbol de trabajo coincidan con el destino. Puede descartar las modificaciones versionadas que no estén en el destino, así que úsalo solo si ese es el resultado que buscas.

Por lo general, los modos de restablecimiento dejan intactos los archivos sin seguimiento que no estén relacionados. Sin embargo, git reset --hard puede eliminar un archivo o directorio sin seguimiento si impide escribir una ruta versionada del destino. Elige --soft cuando necesites que los cambios queden preparados para un commit de reemplazo; elige --mixed si quieres revisarlos como cambios sin preparar. No uses --hard como sustituto del restablecimiento suave.

Cuándo usar git reset --soft de forma segura

El restablecimiento suave sirve para editar el historial local reciente, por ejemplo, para combinar varios commits en uno o preparar sus cambios para otro commit. Antes de ejecutarlo, confirma la rama actual y el destino con git status y git log --oneline. Después, revisa git status y git diff --cached antes de confirmar, para evitar incluir por error cambios preparados que no estén relacionados.

Si los commits ya se compartieron, mover la rama reescribe un historial en el que otras personas quizá basaron su trabajo. Coordina el cambio antes de modificar un historial compartido; si necesitas revertir un cambio público conservando el historial, normalmente conviene más usar un revert. El restablecimiento suave solo cambia el repositorio local hasta que hagas un push, pero subir el historial reescrito puede causar problemas a quienes colaboran contigo. Ten claro el destino y las diferencias preparadas, y evita hacer un push forzado como paso rutinario.