O que fica guardado no stash
O stash é um registro de alterações locais do Git que você pode reaplicar depois. No uso comum de git stash push, ele guarda o estado dos arquivos rastreados no diretório de trabalho e no índice, a área de preparação do commit. Em seguida, esses arquivos voltam ao estado do commit atual.
Esse recurso permite interromper uma edição para trabalhar em outra tarefa. O registro fica disponível na lista local de stashes, separado dos commits da branch. O comando push de git stash push cria esse registro no repositório local e não o envia a um servidor remoto.
Guardar e conferir uma edição
No exemplo didático, você tem uma alteração em um arquivo já rastreado. Estes comandos guardam a alteração com uma mensagem e mostram o conteúdo do registro mais recente:
git stash push -m "ajuste do formulario"git stash show -p 'stash@{0}'O primeiro comando retira a edição dos arquivos de trabalho. O segundo exibe as linhas alteradas, permitindo conferir o que foi guardado. A referência stash@{0} identifica o registro mais recente, portanto pode apontar para outro stash após uma nova criação.
Para recuperar esse registro, use git stash apply 'stash@{0}'. O comando tenta combinar as alterações guardadas com os arquivos atuais e mantém o stash na lista. Alterações posteriores nas mesmas linhas podem produzir conflitos. Nesse caso, você precisa reconciliar o conteúdo nos arquivos e conferir o resultado com git status.
Arquivos novos ficam fora do comportamento padrão. Você pode incluí-los com -u, conforme explicado nas perguntas frequentes, ou mantê-los no diretório de trabalho durante a interrupção.
Dúvidas frequentes
Perguntas frequentes sobre stash
- Como incluir arquivos novos ou ignorados?
- Use git stash push -u para incluir também arquivos não rastreados que não estejam ignorados. A opção -a inclui os ignorados. Confira o conteúdo que será guardado, pois esses arquivos também são retirados do diretório de trabalho.
- Qual é a diferença entre apply e pop?
- O apply reaplica as alterações e mantém o registro na lista de stashes. O pop remove o registro quando a reaplicação tem sucesso. Quando há conflito no pop, o registro permanece na lista.
- O stash preserva o que estava preparado para commit?
- O registro guarda o estado do índice, mas a reaplicação comum não restabelece automaticamente essa separação. A opção --index tenta restaurá-la e pode falhar quando há conflitos.
Para continuar
Recursos relacionados
Documentação
Git: registro e recuperação de alterações locais
Manual dos comandos push, show, apply e pop, com as opções para arquivos novos e restauração do índice.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Acompanhamento ao vivo para examinar alterações guardadas e interpretar conflitos durante a recuperação do trabalho.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O stash permite interromper uma alteração feita com agentes e retomá-la depois, com conferência dos arquivos recuperados.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.