Git stash: como guardar alterações sem fazer um commit
Publicado em 2026-10-26 por frfrand
Salvar trabalho temporário no Git sem perder arquivos nem mesclar branches
Você está corrigindo um formulário, chega um bug urgente e você não quer fazer um commit incompleto. O git stash permite salvar alterações locais enquanto você trabalha em outra coisa. Não é um backup do repositório: é uma pilha local de trabalho temporário.
A ideia é usá-lo para resolver um problema de verdade, não memorizar comandos porque ficam bem em uma captura de tela. Vamos ao essencial, um exemplo de trabalho e os erros que mais convém evitar.
O que o Git stash faz e quando serve
Por padrão, o Git guarda no stash as alterações rastreadas do índice e do diretório de trabalho. Arquivos novos sem rastreamento ficam de fora, a menos que você use -u. Arquivos ignorados precisam de um tratamento diferente; evite colocar credenciais no stash pensando que é um local seguro.
Se você está aprendendo, teste primeiro em um repositório ou ambiente de teste. Se você administra produção, documente o estado antes de executar qualquer coisa que altere arquivos, histórico ou dados. Isso permite entender o que mudou e se recuperar se você errar.
Exemplo para copiar e entender
git status
git stash push -u -m 'formulario a medias'
git stash list
git switch main
# después de resolver el problema
git switch mi-rama
git stash apply stash@{0}
git statusNão copie o comando final sem olhar o estado anterior. Os nomes de branches, host, usuário ou caminhos são exemplos; substitua-os pelos do seu projeto. Alguns comandos modificam arquivos ou fazem requisições que podem gravar dados.
Como eu usaria passo a passo
- Passo 1. Confira primeiro quais modificações aparecem em
git status. - Passo 2. Salve com uma mensagem descritiva.
-uinclui arquivos novos, mas não os ignorados. - Passo 3. Mude de ramo e atenda ao incidente; verifique se o diretório está limpo antes de mudar.
- Passo 4. Volte ao seu ramo, use
applypara recuperar sem excluir o stash e revise os conflitos. - Passo 5. Após verificar e criar o commit, você pode excluir essa entrada com
git stash drop.
Pare após cada passo e comprove o resultado. Se algo falhar, anote a mensagem exata antes de mudar de estratégia. Pular entre cinco soluções aleatórias costuma dificultar encontrar a causa real.
Um caso que pode acontecer com você trabalhando com clientes
Você tem uma API Django e o frontend de reservas pela metade. Um webhook de pagamentos falha. Você salva a mudança do frontend, corrige o webhook em outro ramo, publica o commit e recupera o formulário sem copiar arquivos manualmente.
O objetivo não é que «funcione uma vez», mas que você possa explicar como repete sem comprometer outra aplicação. Se houver dados ou credenciais de clientes, trabalhe com testes separados e acessos mínimos.
O erro que mais vejo
git stash pop aplica e, se terminar bem, exclui a entrada; apply a conserva. Se as mudanças importam para você, comece por apply. O stash vive no clone local: não é um backup sincronizado ao GitHub.
Uma regra simples: se você não puder explicar o que o comando fará no seu código ou servidor, consulte primeiro a ajuda oficial. Assim, você evita confundir uma solução rápida com um novo problema.
Onde entra o ArduMaker?
Em um projeto implantado com Git a partir do ArduMaker, registre o commit exato que vai para produção. O stash serve apenas para organizar o trabalho na sua máquina; o servidor deve implantar uma revisão verificável.
Por exemplo, você pode implantar a partir de um repositório Git em um VPS, associar um domínio HTTPS e administrar serviços e bancos de dados no mesmo ambiente. O painel reduz tarefas repetitivas de infraestrutura, mas não substitui o Git, os testes nem a revisão de permissões do projeto.
Perguntas rápidas antes de aplicá-lo
Isso altera a produção? Depende de onde você executa a ação. Teste localmente primeiro, identifique o commit ou serviço afetado e prepare um plano de recuperação.
Como comprovar que deu certo? Não fique apenas na ausência de mensagens de erro: verifique o status, execute um teste funcional e confira os logs ou o histórico correspondente.
Vale a pena automatizar? Se for repetível e tiver resultados verificáveis, sim. Mas a automação deve falhar de forma clara e não esconder erros ou credenciais.
Para ampliar
Resumo: a ferramenta útil não é a que tem mais opções, mas sim a que permite entender o que mudou, comprovar isso e continuar trabalhando sem surpresas.