Como resolver Please, commit your changes or stash them before you can merge.
Neste artigo você vai aprender a resolver Please, commit your changes or stash them before you can merge. Um problema frequente de git

Fala programador(a), beleza? Bora aprender mais sobre git e suas mensagens!
A primeira coisa que precisamos entender aqui é que isto não é um erro, e sim uma trava de segurança do git
Geralmente recebemos esta mensagem quando estamos mudando de branch com git checkout, mas já realizamos algum código no branch atual
O git nos previne de prever este código, falando para utilizarmos o comando de commit ou stash
Estes comandos servem para salvar o código atual, e assim também poder resgatar ele se alguma ação indevida for feita
Quer aprender mais sobre git? Veja este curso gratuito:
Como fazer o git parar de exibir a mensagem?
Você deve commitar as alterações ou enviá-las para a stash
Os seguintes comandos podem ser utilizados:
git commit -m "Adding some code"
Neste caso você está salvando as alterações
A stash pode ser feita com:
git stash
Assim você colocar o seu código numa espécie de ‘lixeira’, que pode ser revertido posteriormente
Utilize este método se o código atual não importa para a sua futura ação
Após um destes comandos você já pode realizar o seu git checkout, a mensagem de aviso deve ter desaparecido 🙂
Conclusão
No artigo de hoje você aprendeu a como resolver Please, commit your changes or stash them before you can merge.
É uma mensagem de aviso do git, que trava uma possível perda de código
Para fazer o git parar de exibir a mensagem, possibilitando a sua ação, utilize o git commit ou o git stash
Assim você estará liberado para fazer o que estava tentando antes da mensagem ser exibida
Confira nossos cursos gratuitos no Youtube, com vídeos todos os dias! Se inscreva e ative o sininho para receber as notificações e aprender mais ainda sobre desenvolvimento web!
Veja também nosso catálogo de cursos na Udemy, todos com exercícios e projetos práticos, nas mais diversas tecnologias. O link acima contém um cupom de desconto para os cursos!
Adicionar um bloco curto listando as variações da MESMA mensagem, porque o git mostra ela em situações diferentes:
O git solta esse mesmo aviso em mais de um cenário, o fim da frase muda mas a causa é a mesma
‘before you switch branches’ aparece quando tu tenta trocar de branch
‘before you merge’ aparece quando tu tenta juntar um branch no outro com git merge
‘before you can merge’ costuma vir num git pull, que faz um merge por baixo dos panos
Em todos eles o motivo é o mesmo: tu tem código não salvo no branch atual e o git trava pra não perder teu trabalho
A boa notícia? A solução é idêntica pros três, commit ou stash, é o que a gente vê agora
Adicionar o passo que mostra COMO resgatar o código guardado, já que o texto promete que dá pra reverter mas não ensina:
E pra trazer o código de volta depois? Tu roda:
git stash pop
Isso pega o que estava guardado e devolve pro teu branch, aí tu continua de onde parou
Se quiser dar uma olhada no que tem guardado antes, o git stash list te mostra a lista
Adicionar uma seção curta de dúvidas comuns, cada pergunta como subtítulo:
Commit ou stash, qual eu uso?
Use o commit quando o código atual já está num ponto que tu quer guardar de verdade no histórico
Use o stash quando é só um trabalho no meio do caminho, algo que tu quer tirar da frente rapidinho pra trocar de branch e depois retomar
E se eu não quiser guardar as alterações?
Aí tu pode simplesmente descartar o que fez no branch atual antes de trocar
Só cuidado, código descartado não volta, então tenha certeza antes
Trocar de branch, dar merge ou pull mostram o mesmo aviso?
Sim, é a mesma trava de segurança do git em situações diferentes, e resolve do mesmo jeito: commit ou stash
Leia também
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 473 aulas
- 20 projetos
- 39h 26min
Blog | Mais populares
As diferenças de var, let e const
Como fazer redirecionamento com PHP
Neste artigo você vai aprender a como fazer redirecionamento com PHP, utilizaremos abordagens fáceis de entender e de aplicar Fala programador(a), beleza? Bora aprender mais […]
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação
Checklist de segurança n8n VPS pública: guia essencial para proteger sua instalação A popularidade da automação de processos com o n8n está em alta, principalmente […]