Normalmente, você usará git rebase
para:
- Editar mensagens anteriores do commit
- Combinar vários commits em um
- Excluir ou reverter commits que não são mais necessários
Aviso: como a alteração do seu histórico de commits pode dificultar as coisas para todos os outros que usam o repositório, é considerada uma prática inadequada fazer a troca de base de commits quando você já efetuou push deles para um repositório. Para saber como trocar a base com segurança no GitHub.com, confira "Sobre as mesclagens da solicitação de pull".
Fazer rebase de commits em um branch
Para fazer rebase de todos os commits entre outro branch e o estado do branch atual, você pode inserir o seguinte comando no shell (ou o prompt de comando para Windows, ou o terminal para Mac e Linux):
$ git rebase --interactive OTHER-BRANCH-NAME
Fazer rebase de commits em um momento específico
Para fazer rebase dos últimos commits em seu branch atual, você pode inserir o seguindo comando no shell:
$ git rebase --interactive HEAD~7
Comandos disponíveis ao fazer rebase
Há seis comandos disponíveis para fazer rebase:
pick
pick
significa simplesmente que o commit está incluído. A reorganização da ordem dos comandospick
altera a ordem dos commits quando a troca de base está em andamento. Se você optar por não incluir um commit, será preciso excluir a linha toda.reword
- O comando
reword
é semelhante apick
, mas depois que você usá-lo, o processo de troca de base será colocado em pausa e dará a você a chance de alterar a mensagem de commit. As alterações feitas pelo commit não são afetadas. edit
- Se você optar por
edit
um commit, terá a chance de alterar o commit, o que significa que pode adicionar ou alterar o commit por completo. Também é possível fazer mais commits antes de continuar com o rebase. Isso permite que você divida um commit grande em commits menores ou remova alterações equivocadas feitas em um commit. squash
- Esse comando permite combinar dois ou mais commits em um único commit. Um commit é combinado por squash no commit acima dele. O Git permite que você grave uma nova mensagem do commit descrevendo ambas as alterações.
fixup
- Isso é semelhante a
squash
, mas o commit a ser mesclado tem a mensagem descartada. O commit simplesmente sofre merge no commit acima dele, e a mensagem do commit anterior é usado para descrever ambas as alterações. exec
- Permite que você execute comandos de shell arbitrários em um commit.
Um exemplo de uso de git rebase
Independentemente do comando usado, o Git iniciará o editor de texto padrão e abrirá um arquivo que fornece detalhes dos commits no intervalo escolhido. Esse arquivo é parecido com este:
pick 1fc6c95 Patch A
pick 6b2481b Patch B
pick dd1475d something I want to split
pick c619268 A fix for Patch B
pick fa39187 something to add to patch A
pick 4ca2acc i cant' typ goods
pick 7b36971 something to move before patch B
# Rebase 41a72e6..7b36971 onto 41a72e6
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
#
# If you remove a line here THAT COMMIT WILL BE LOST.
# However, if you remove everything, the rebase will be aborted.
#
Ao dividir essas informações, de cima para baixo, observamos que:
- Sete commits são listados, o que indica que houve sete alterações entre nosso ponto de partida e o estado do nosso branch atual.
- Os commits escolhidos para rebase são classificados na ordem das alterações mais antigas (no topo) para as mais recentes (na base).
- Cada linha lista um comando (por padrão,
pick
), o SHA do commit e a mensagem de commit. Todo o procedimentogit rebase
gira em torno da manipulação dessas três colunas. As alterações feitas tem a base trocada no repositório. - Após os commits, o Git informa o intervalo de commits com o qual estamos trabalhando (
41a72e6..7b36971
). - Por fim, o Git fornece alguma ajuda informando a você os comandos que estão disponíveis ao fazer rebase dos commits.