O que é git stash e quando você o utiliza?

Question

Accepted Answer

**git stash** **salva temporariamente suas alterações não confirmadas** e reverte seu diretório de trabalho para um estado limpo — para que você possa alternar contextos (por exemplo, corrigir um bug urgente em outro branch) sem confirmar trabalho inacabado e depois restaurar as alterações mais tarde.

## O problema que stash resolve

```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` salva alterações e limpa o diretório de trabalho; `git stash pop` as restaura mais tarde (e remove o stash). `apply` restaura sem remover.

## Cenário comum

```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
```

## Opções úteis

```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 que isso importa

Compreender `git stash` é valioso para **lidar com alternâncias de contexto de forma limpa**, uma situação comum no mundo real, então é um conhecimento prático útil de Git.

O problema que resolve é frequente: você está no meio do trabalho com alterações não confirmadas quando precisa **alternar contexto urgentemente** (corrigir um bug de produção em outro branch, revisar código de alguém, puxar atualizações) — mas alternar branches com alterações não confirmadas é problemático (Git pode recusar ou carregá-las de forma confusa), e confirmar trabalho inacabado polui o histórico. **Stash** resolve isso elegantemente ao **salvar suas alterações de lado** e lhe dar um diretório de trabalho limpo para alternar contextos, depois **restaurá-las mais tarde** quando você voltar — encaixando-se exatamente no cenário comum "preciso abandonar o que estou fazendo temporariamente".

Compreender os comandos principais (`git stash` para salvar, `git stash pop` para restaurar-e-remover, `git stash apply` para restaurar-e-manter, `git stash list` para ver stashes) e o fluxo típico (stash no trabalho em progresso, alternar e lidar com a tarefa urgente, alternar de volta e fazer pop) é conhecimento prático cotidiano para gerenciar interrupções.

Conhecer opções úteis (`-u` para incluir arquivos não rastreados, visualizar conteúdo do stash) e que stash é para armazenamento **temporário** (não um substituto de longo prazo para commits/branches) reflete uso adequado.

Como alternâncias de contexto e interrupções são comuns no desenvolvimento (bugs urgentes, revisões, precisar de um diretório de trabalho limpo), e como stash fornece uma forma limpa e conveniente de temporariamente colocar de lado trabalho não confirmado e restaurá-lo depois, compreender `git stash` — o que resolve, os comandos e o fluxo de alternância de contexto comum — é um conhecimento prático e relevante de Git para lidar com a necessidade frequente do mundo real de alternar contextos sem confirmar trabalho inacabado, uma ferramenta útil que suaviza as interrupções comuns do desenvolvimento diário.