Desfazer um merge com segurança

Antes de desfazer, consulte git status. Como você já viu, ele indica conflitos pendentes. Mas atenção: resolver os arquivos e prepará-los não conclui o merge; ainda falta registrar o commit.

• Merge em andamento e integração desejada: continue a resolução e conclua o merge.
• Merge em andamento e integração indesejada: git merge --abort interrompe a operação pendente.
• Merge já registrado e mudanças indesejadas: git revert cria um novo commit para desfazer mudanças, sem apagar o histórico.

O abort não desfaz um merge já concluído.

Faça este ensaio no seu computador, sem publicar no GitHub e sem usar trabalho importante. No terminal, entre em uma pasta onde você guarda seus projetos, fora de qualquer repositório existente.

Os comandos abaixo funcionam no Git Bash do Windows e em terminais Bash ou Zsh do macOS/Linux. Eles criam um repositório com as branches destino e proposta, que alteram a mesma linha de mensagem.txt. Se a pasta ensaio-merge-seguro já existir, escolha outro nome para os dois primeiros comandos.

Se algum comando falhar, pare antes de continuar.

Antes de integrar, execute os comandos abaixo. Anote a branch atual, o identificador do último commit e o conteúdo do arquivo.

Você deve estar em destino, com o último commit “Altera mensagem no destino” e o arquivo contendo Mensagem: destino. O git status deve indicar estado limpo, sem alterações pendentes.

Execute este bloco. O conflito em mensagem.txt é esperado: o merge ficará em andamento, sem um commit de conclusão. Confira os caminhos não mesclados no git status.

Com o conflito confirmado, execute o próximo bloco, sem resolver nem registrar o merge. Atenção: git merge --abort também abandona as edições feitas para tentar resolver esse merge.

Depois, compare com suas anotações: o estado deve estar limpo e sem merge pendente; a branch deve continuar sendo destino; o identificador do último commit deve ser o mesmo; e o arquivo deve voltar a conter Mensagem: destino, sem marcadores de conflito.

O abort não cria um commit de reversão nem altera os commits existentes: ele cancela a integração ainda não concluída.

Se o abort falhar ou o resultado for diferente do esperado, pare e leia o estado informado pelo Git antes de continuar.

Continue no repositório local do ensaio anterior. Confira que você está na mesma branch de destino e que o estado está limpo, sem merge pendente. Só então repita a integração.

Nos comandos abaixo, substitua RAMO_INTEGRADO pelo nome da branch que você tentou integrar e ARQUIVO pelo nome do arquivo de texto do ensaio. Não use um projeto com trabalho importante.

Execute uma linha por vez. Se as conferências não corresponderem ao esperado, pare antes do merge.

O mesmo conflito deve reaparecer. No seu editor, substitua todo o conteúdo do arquivo em conflito pela linha abaixo, sem marcadores, e salve.

Confira se a diferença preparada contém exatamente a resolução definida.

Se a revisão estiver correta, conclua. A opção --no-edit aceita a mensagem padrão sem abrir um editor. O status final deve estar limpo.

Exiba o histórico. Neste ensaio, o commit apontado por HEAD é o merge que você acabou de concluir. Anote seu identificador.

Localize também o último commit da branch de destino antes da integração: ele deve corresponder à referência que você registrou antes de iniciar o merge.

Use git show --no-patch --pretty=raw com o identificador do merge. Como ele ainda é o último commit neste ensaio, você pode usar HEAD, como abaixo.

Leia as duas linhas parent na ordem em que aparecem:

• Primeira: pai 1, o commit em que estava a branch de destino antes do merge.
• Segunda: pai 2, a ponta da branch que foi integrada.

Compare os identificadores com o grafo e com sua referência anterior. O pai 1 não depende de a branch se chamar main: depende de onde o merge foi executado.

Anote o identificador do merge e os dois pais, na ordem exibida. Guarde essas referências para a próxima etapa.

A integração foi executada na branch entrega. Os identificadores do grafo estão abreviados; abaixo dele aparecem trechos dos metadados do merge.

Com o merge concluído, use git revert -m 1 <commit-de-merge> para criar um novo commit que inverte as mudanças introduzidas pelo merge em relação ao primeiro pai.

O -m 1 escolhe o pai 1 como referência principal: no nosso ensaio, o estado da branch de destino antes da integração, que você já identificou. Não significa “desfazer um commit” nem “usar a branch número 1”.

Na prática, acrescentaremos --no-edit para aceitar a mensagem padrão da reversão sem abrir um editor.

No terminal, dentro do repositório de aprendizado, execute as conferências abaixo. A branch marcada com * deve ser a que recebeu o merge; o estado deve estar limpo, sem merge pendente; e o último commit deve ser o merge cujos dois pais você confirmou.

Continue apenas nesse cenário, sem commits posteriores ao merge e sem tê-lo compartilhado. Se algo não corresponder, pare e confira antes de executar a reversão.

Compare o identificador exibido pelo log com o merge identificado na etapa anterior.

Substitua <commit-de-merge>, incluindo os sinais < e >, pelo identificador real confirmado. Só então execute. O terminal deve confirmar um novo commit, normalmente com uma mensagem iniciada por “Revert”.

No repositório local do ensaio, após o revert:

1. Abra o arquivo no seu editor e compare seu conteúdo com a referência registrada antes do merge.
2. Execute os comandos abaixo: confira a branch de destino e a ausência de alterações pendentes no status.
3. No histórico, localize o novo commit de reversão e o merge, que deve continuar presente.

Neste ensaio, sem commits entre o merge e a reversão, o conteúdo versionado volta ao estado do primeiro pai. O histórico, porém, inclui o merge e sua reversão.

O objetivo não é apenas fazer o arquivo parecer como antes: é desfazer as mudanças da integração mantendo o merge e registrando a reversão em um novo commit.

Nem abortar nem reverter exclui automaticamente a branch integrada.

• Após um abort, a integração não foi registrada. A branch continua disponível para ajustes e outra tentativa de merge.
• Após um revert, os commits continuam no histórico integrado, mas suas mudanças foram desfeitas. Repetir o merge sem novos commits não as reaplica; o Git pode informar que tudo já está atualizado.
• Com novos commits na branch, é possível integrar novidades, mas isso não restaura automaticamente as mudanças antigas revertidas.

O caminho usual é reverter o commit de revert. Isso cria outro commit que desfaz a reversão, sem apagar o histórico.

A forma abaixo é apenas uma referência conceitual; não execute agora. O identificador deve ser o do commit de reversão, não o do merge original.

1. Inspecione com git status e confira a branch.
2. Identifique: o merge está em andamento ou já foi registrado?
3. Confira as condições de segurança e, para reverter, o commit e seus pais.
4. Execute a ação adequada.
5. Valide o conteúdo dos arquivos, a branch e o histórico — não apenas o status.