A alteração reunida em um commit
O squash é a combinação das alterações de vários commits em um único commit. Ele permite registrar uma mudança completa sem incluir, no histórico de destino, cada ajuste intermediário feito durante seu desenvolvimento. A mensagem do novo commit precisa descrever o resultado combinado.
O Git oferece mais de uma forma de fazer essa combinação. A opção git merge --squash prepara os arquivos e o índice, que reúne as alterações selecionadas para o próximo commit. O comando mantém HEAD, a referência ao commit atual, na mesma posição. Depois, você cria o commit separadamente, conforme o manual do git merge.
Uma branch com implementação e correções
Em um exemplo didático, a branch ajuste-login contém três commits: a implementação de uma validação, a correção de uma mensagem e um teste. Com a branch main selecionada e a árvore de trabalho limpa, a sequência abaixo prepara a integração e registra o resultado:
git merge --squash ajuste-logingit diff --cachedgit commit -m "Valida o formulário de login"O primeiro comando combina as alterações. O segundo mostra o conteúdo preparado no índice para você revisar. O terceiro cria o commit, depois da revisão e dos testes necessários. Se houver conflito, a sequência exige que você resolva os arquivos e adicione as resoluções ao índice antes de continuar.
O resultado em main é um commit comum, com um único pai, sem registrar ajuste-login como uma branch integrada por um merge convencional. Os três commits continuam na branch de origem. Essa diferença de ancestralidade precisa ser considerada ao reutilizar a branch em outra integração. O rebase interativo oferece outra forma de combinar commits, mas reescreve a sequência escolhida.
Dúvidas frequentes
Perguntas frequentes sobre squash
- O squash apaga os commits da branch de origem?
- Uma integração com git merge --squash não altera a branch de origem. O destino recebe um novo commit com o resultado combinado, sem incorporar a sequência original como ancestral desse commit.
- Git merge --squash pode apresentar conflitos?
- Sim. A combinação das alterações pode exigir resolução de conflitos. Você precisa conferir os arquivos resultantes e preparar as resoluções no índice antes de criar o commit.
- O squash também pode ser feito com rebase?
- Sim. O rebase interativo permite combinar commits com squash ou fixup. Esse procedimento reescreve a sequência selecionada, enquanto o merge --squash prepara uma integração na branch atual.
Para continuar
Recursos relacionados
Documentação
Git: integração com squash
Documenta a opção --squash e explica o que ela altera na árvore de trabalho, no índice e no histórico.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para revisar alterações de código e trabalhar na integração de uma branch.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de alterações inclui conferir o conteúdo integrado e entender como cada forma de merge registra o histórico.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.