¿Qué es git stash y cuándo lo utilizas?

Question

Accepted Answer

**git stash** **guarda temporalmente tus cambios sin hacer commit** y revierte tu directorio de trabajo a un estado limpio — para que puedas cambiar de contexto (por ejemplo, arreglar un bug urgente en otra rama) sin hacer commit de trabajo a medio terminar, y luego restaurar los cambios más tarde.

## El problema que stash resuelve

```text
You're mid-work with uncommitted changes, but need to switch context urgently:
  → switch branches? Git may refuse (uncommitted changes would conflict) or carry
    them along messily
  → commit half-done work? No — it's not ready (pollutes history)
→ STASH saves your changes aside, giving you a clean working directory to switch.
```

## Usando stash

```bash
git stash                      # save uncommitted changes; working dir becomes clean
git stash push -m "message"    # stash with a description
git stash list                 # list stashes (stash@{0}, stash@{1}, ...)

git stash pop                  # RESTORE the latest stash AND remove it from the list
git stash apply                # restore but KEEP it in the stash list
git stash apply stash@{1}      # apply a specific stash
git stash drop stash@{0}       # delete a stash
git stash clear                # remove all stashes
```

`git stash` guarda los cambios y limpia el directorio de trabajo; `git stash pop` los restaura más tarde (y elimina el stash). `apply` restaura sin eliminar.

## Escenario común

```bash
# working on a feature, but an urgent bug needs fixing on main:
git stash                      # save the in-progress feature work
git switch main
# ... fix the urgent bug, commit, push ...
git switch feature
git stash pop                  # restore the feature work and continue
```

## Opciones útiles

```text
git stash -u        → also stash UNTRACKED files (not just tracked changes)
git stash show -p   → see what's in a stash
→ Stash is for TEMPORARY storage — not a substitute for commits/branches long-term.
```

## Por qué es importante

Comprender `git stash` es valioso para **manejar cambios de contexto de forma limpia**, una situación común en la práctica real, por lo que es un conocimiento práctico de Git muy útil.

El problema que resuelve es frecuente: estás en medio del trabajo con cambios sin hacer commit cuando necesitas **cambiar de contexto urgentemente** (arreglar un bug en producción en otra rama, revisar código de alguien, obtener actualizaciones) — pero cambiar de rama con cambios sin commit es problemático (Git puede rechazarlos o transportarlos de forma desordenada), y hacer commit de trabajo a medio terminar contamina el historial. **Stash** resuelve esto elegantemente **guardando tus cambios aparte** y dándote un directorio de trabajo limpio para cambiar de contexto, luego **restaurándolos más tarde** cuando regreses — encajando exactamente en el escenario común de "necesito dejar lo que estoy haciendo temporalmente".

Comprender los comandos principales (`git stash` para guardar, `git stash pop` para restaurar-y-eliminar, `git stash apply` para restaurar-y-mantener, `git stash list` para ver stashes) y el flujo de trabajo típico (stash del trabajo en progreso, cambiar y manejar la tarea urgente, cambiar de vuelta y hacer pop) es conocimiento práctico cotidiano para manejar interrupciones.

Conocer opciones útiles (`-u` para incluir archivos sin seguimiento, ver contenidos de stash) y que stash es para almacenamiento **temporal** (no un sustituto a largo plazo para commits/ramas) refleja un uso correcto.

Ya que los cambios de contexto e interrupciones son comunes en el desarrollo (bugs urgentes, revisiones, necesidad de un directorio de trabajo limpio), y dado que stash proporciona una forma limpia y conveniente de guardar temporalmente trabajo sin commit y restaurarlo después, comprender `git stash` — qué resuelve, los comandos y el flujo de trabajo típico de cambio de contexto — es un conocimiento práctico y relevante de Git para manejar la necesidad real y frecuente de cambiar de contexto sin hacer commit de trabajo inacabado, una herramienta útil que suaviza las interrupciones comunes del desarrollo diario.