Como resolver conflitos de mesclagem no tutorial do Git

Tipos de mesclagem

O Git merge e o rebase são as duas maneiras de integrar os commits do branch de destino ao branch de origem. Além disso, a mesclagem do Git executa uma mesclagem de avanço rápido ou de não avanço rápido. Se o cabeçalho do ramo de destino existir no ramo de origem, então, por padrão, o tipo de mesclagem será uma mesclagem de avanço rápido e, se estiver faltando, será uma mesclagem sem avanço rápido. O rebase do Git é outro tipo de mesclagem que sequencia novamente o histórico de commits do branch de destino. 

Fusão de avanço rápido

Por padrão, o Git Merge usa o avanço rápido para integrar os commits ausentes no branch de destino. Por exemplo, ele é usado para atualizar a ramificação local de um servidor remoto usando o comando pull. O avanço rápido não gera problemas de conflito de mesclagem, pois o Git não o aplicará se o cabeçalho do ramo de destino estiver ausente no ramo de origem. 

Mesclagem sem avanço rápido

Uma mesclagem no-fast-forward também é chamada de mesclagem de três vias ou verdadeira. Ele cria um novo commit em um branch de destino integrando as alterações no branch de origem e no branch de destino. As alterações são combinadas após o último commit comum em ambas as ramificações. No nosso caso, é após o C. Esse tipo de mesclagem gerará um conflito de mesclagem do Git se o ramo de origem estiver em disputa com o ramo de destino. No diagrama acima, o commit de mesclagem (X) é criado pela integração da origem e do ramo de destino, em que K e E são as origens do commit de mesclagem. 

Rebase 

O rebase do Git é um pouco diferente dos outros tipos. Ele altera a sequência do histórico de commits do ramo de destino. O rebase integra o ramo de origem de forma que o ramo de destino contenha todas as alterações do ramo de origem, seguidas de todos os commits do ramo de destino após o último commit comum. No nosso caso, o último commit comum é o C, enquanto o D e o E são do ramo de origem. O commit K* é o mesmo que K com um ID de commit diferente. Em vez de vincular C, você estará vinculando E. Semelhante a uma mesclagem sem avanço rápido, se houver problemas de compatibilidade na origem e no ramo de destino, o Git levantará um problema para resolver o conflito antes de finalizar o rebase. 

Tipos de conflitos de mesclagem do Git

Há dois tipos de conflitos de mesclagem do Git: no início e durante o processo de mesclagem - Atlassian. Nesta seção, aprenderemos sobre os dois tipos e as maneiras de resolver cada cenário. 

No início da mesclagem

A mesclagem do Git falhará no início se houver alterações no diretório de trabalho ou na área de preparação. Ele falha no início para evitar que as alterações sejam substituídas por commits de mesclagem recebidos. Isso ocorre devido a conflitos com alterações locais, não com outras ramificações ou desenvolvedores. Para estabilizar o estado local, você pode usar comandos como git stash, git commit, git checkout, ou git reset.

Durante a mesclagem

Uma falha durante a mesclagem significa que há um conflito entre o ramo de origem e o ramo de destino em que vários desenvolvedores modificaram o mesmo arquivo. Se a mesclagem automática falhar, o Git solicitará que você resolva os problemas manualmente. Você também pode usar ferramentas de terceiros para ajudá-lo a visualizar e integrar as alterações.

Comandos para resolver conflitos de mesclagem do Git

Nesta seção, aprenderemos sobre vários comandos nativos para visualizar e resolver os conflitos de mesclagem do Git. 

Comandos comuns

O status do Git é o comando usado com mais frequência para exibir o status dos arquivos modificados, a área de preparação e os commits. Durante o processo de mesclagem, ele é usado para identificar arquivos conflitantes.  

git status

O registro do Git com os argumentos --merge produz a lista de commits que estão em conflito com o ramo de origem. 

git log --merge

Por padrão, a opção git diff mostrará a você a diferença entre as alterações não confirmadas e as confirmações anteriores. O Git diff é usado para comparar ramificações, commits e arquivos. Isso é útil para evitar futuros conflitos de mesclagem. 

git diff 

Comandos para falhas de mesclagem no início

O checkout é usado para desfazer alterações ou mudar para uma ramificação nova ou antiga. 

git checkout

A redefinição do Git serve para reverter as alterações no diretório de trabalho e na área de preparação. 

git reset --mixed

Comandos para conflitos durante a mesclagem

O argumento --abort interromperá o processo de mesclagem e reverterá as alterações para o estado original antes do início da mesclagem. 

git merge --abort

A redefinição do Git é normalmente usada durante o processo de mesclagem para reverter os arquivos em conflito para o estado original.

git reset

Resolver conflitos entre arquivos modificados e excluídos

O conflito do Git ocorrerá se você tiver excluído o arquivo no ramo atual e outra pessoa o tiver modificado em outro ramo. Nesse caso, você pode adicionar um arquivo e fazer o commit,

git add <filename>

ou você pode remover o arquivo e confirmar. 

git rm <filename>

📌 Folha de dicas de resolução de conflitos de mesclagem do Git

Ferramentas de mesclagem visual

As ferramentas de mesclagem são ferramentas visuais fáceis de usar para identificar e resolver todos os tipos de conflitos de mesclagem. Algumas das ferramentas oferecem suporte a recursos adicionais, como comparação de alterações, operações do Git e gerenciamento de projetos e repositórios. Há dois tipos de ferramentas de mesclagem do Git: somente terminal e baseadas em GUI. As ferramentas baseadas em terminal são abertas no PowerShell ou no Bash e as ferramentas baseadas em GUI são abertas em um ambiente com janelas. 

Para verificar a lista de ferramentas instaladas e válidas, use:

git mergetool --tool-help 

A lista consiste em todas as ferramentas válidas que podem ser instaladas e integradas aos comandos git.

Por exemplo, temos o vim e o nvim instalados por padrão e, se você quiser ver a diferença entre um arquivo sem commit e um commit anterior, digite:

git difftool --tool=vimdiff3

A ferramenta vimdiff3 destaca as alterações e permite que você compare os commits no terminal. 

Diferença entre duas versões do mesmo arquivo no vimdiff3

Fusão

O Meld é uma ferramenta gratuita e de código aberto que leva a resolução de conflitos de mesclagem a outro nível. Para integrá-lo ao Git, você precisa primeiro fazer o download e instalar a configuração do site oficial. Em seguida, adicione-o à configuração global para que, por padrão, o Git inicie o Meld para resolver conflitos.  

Os comandos de configuração abaixo são aplicáveis apenas a usuários do Windows. A única alteração que você precisa fazer é mudar o caminho do arquivo instalado do Meld para Mac ou Linux. 

git config --global merge.tool meld 

git config --global mergetool.meld.path "C:/Program Files (x86)/Meld/Meld.exe" 

git config --global diff.tool meld

git config --global difftool.meld.path "C:/Program Files (x86)/Meld/Meld.exe"

Depois de configurar os padrões, você pode digitar git difftool no diretório local do Git para iniciar a versão do Meld para Windows, ou você pode git mergetool para resolver conflitos de mesclagem, conforme mostrado abaixo.

Resolução de um conflito de mesclagem com o Meld

VSCode

O VSCode oferece a melhor e mais popular maneira de resolver o conflito de mesclagem. Quando o Git não conseguir mesclar arquivos automaticamente, o VSCode destacará o código em conflito e dará a você quatro opções: aceitar alterações atuais, aceitar alterações recebidas, aceitar ambas as alterações e comparar alterações. Você pode usar essas opções para limpar seu arquivo e resolver todos os problemas pendentes. 

Resolução de um conflito de mesclagem com o VSCode

Se você estiver procurando uma solução completa para suas operações Git, experimente o GitKraken. Ele vem com um cliente gratuito, extensão VSCode, e fornece uma ferramenta integrada para resolver conflitos de mesclagem.  

Como resolver um conflito de mesclagem do Git

Nesta seção, aprenderemos a criar um conflito de mesclagem do Git e a resolvê-lo. O tutorial é dividido em duas partes. Na primeira parte, aprenderemos a resolver conflitos do Git localmente; a segunda parte trata da resolução de conflitos com um servidor remoto (GitHub).

Conflito de mesclagem local

A criação de conflitos de mesclagem nos ajudará a aprender como esses problemas surgem em primeiro lugar. Assim, podemos usar formas criativas para resolver esses problemas ou até mesmo evitar que eles ocorram no futuro. 

Agora, criaremos um repositório Git com um único arquivo e criaremos nosso primeiro commit para você começar. 

1. Crie uma pasta chamada datacamp.
2. Altere o diretório para DataCamp.
3. Inicializar o Git.
4. Crie um arquivo README.md com o título fornecido.
5. Faça o stage e confirme as alterações em um arquivo.

mkdir datacamp
cd datacamp
git init
echo "# How to Resolve Git Merge Conflict" > README.md
git add README.md
git commit -m "first commit"

>>> [main (root-commit) 8199ea2] first commit
>>>  1 file changed, 1 insertion(+)
>>> create mode 100644 README.md

Em seguida, criaremos um novo readme de ramificação e alteraremos o título de "...Git Merge..." para "...Git...". Adicione o arquivo e crie o commit usando o argumento -am.

git checkout -b readme
echo "# How to Resolve Git Conflict" > README.md
git commit -am "new branch conflict added"

>>> [readme 155f694] new branch conflict added
>>> 1 file changed, 1 insertion(+), 1 deletion(-)

Volte para a ramificação principal e adicione uma nova linha ao arquivo README.md usando >>. Ao salvar as alterações e criar commits, conseguimos criar um conflito entre duas versões do mesmo arquivo. 

git checkout main
echo "New change in base branch" >> README.md
git commit -am " a line added to base branch Readme file"

>>> [main f1f1874]  a line added to base branch Readme file
>>> 1 file changed, 1 insertion(+)

Como podemos ver, ao mesclar o ramo leia-me, o Git exibiu uma mensagem dizendo que a mesclagem automática falhou e que precisamos fazer alterações manualmente e, em seguida, confirmar o resultado. 

git merge readme

>>> Auto-merging README.md
>>> CONFLICT (content): Merge conflict in README.md
>>> Automatic merge failed; fix conflicts and then commit the result.

Resolveremos o problema manualmente abrindo e editando o arquivo no Bloco de Notas. A imagem abaixo mostra a seta com HEAD, um divisor e uma seta de direção diferente com um readme. A parte HEAD mostra as alterações existentes na ramificação principal, e a parte readme é a ramificação que queremos mesclar, que consiste em um título diferente. 

Resolução manual de um conflito de mesclagem

Para resolver o problema, removeremos a parte do ramo leia-me, as setas e o divisor. A versão final do arquivo deve ter uma aparência limpa, como mostrado abaixo. 

Conflito resolvido 

Depois que adicionarmos o arquivo e criarmos um commit, o conflito de mesclagem será resolvido. É a maneira mais comum e mais simples de resolver problemas. Você também pode usar um ambiente de desenvolvimento integrado (IDE) para resolver problemas mais rapidamente.

git commit -am "conflict resolved in file README.md"
>>> [main 9994a29] conflict resolved in file README.md

Conflito de mesclagem remota

Para criar e resolver conflitos de mesclagem remota, precisamos criar um novo repositório no GitHub.

Criando um novo repositório no GitHub

Em seguida, adicione o nome remoto (origem) com o endereço ao repositório e envie todas as alterações de um repositório local para a ramificação principal remota usando o upstream.

git remote add origin https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
git push --set-upstream origin main


>>> Enumerating objects: 12, done.
>>> Counting objects: 100% (12/12), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (12/12), 998 bytes | 499.00 KiB/s, done.
>>> Total 12 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), done.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  * [new branch]      main -> main
>>> branch 'main' set up to track 'origin/main'.

Para criar um conflito, precisamos fazer alterações no arquivo README.md remoto e local. Você pode usar o editor de arquivos do GitHub para alterar "...Git merge..." para "...Sit-Merge..." e, em seguida, fazer o commit das alterações. 

Fazendo alterações no editor do GitHub

Em seguida, no repositório local, altere o arquivo README.md para adicionar apenas um título simples e confirme as alterações. 

echo "# How to Resolve Merge Conflicts in Git Tutorial" > README.md
git commit -am "local branch changes in README.md"

>>> [main c677a13] local branch changes in README.md
>>>  1 file changed, 1 insertion(+), 4 deletions(-)

Por fim, envie as alterações para o servidor remoto. Observe que o Git apresentou o erro com dicas sobre como eliminar o problema. 

git push


>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  ! [rejected]        main -> main (fetch first)
>>> error: failed to push some refs to 'https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git'
>>> hint: Updates were rejected because the remote contains work that you do
>>> hint: not have locally. This is usually caused by another repository pushing
>>> hint: to the same ref. You may want to first integrate the remote changes
>>> hint: (e.g., 'git pull ...') before pushing again.
>>> hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Seguiremos a dica mais simples, que é extrair o arquivo do servidor remoto antes de enviar. 

A extração do arquivo falhou devido a um conflito de mesclagem no arquivo README.md. Poderíamos corrigi-lo manualmente usando o Bloco de Notas, mas desta vez usaremos uma ferramenta visual para nos ajudar nesse processo. 

git pull


>>> remote: Enumerating objects: 5, done.
>>> remote: Counting objects: 100% (5/5), done.
>>> remote: Compressing objects: 100% (2/2), done.
>>> remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
>>> Unpacking objects: 100% (3/3), 681 bytes | 75.00 KiB/s, done.
>>> From https://github.com/kingabzpro/DataCamp-Git-Merge-Guide
>>>    aaf149d..49b7d14  main       -> origin/main
>>> Auto-merging README.md
>>> CONFLICT (content): Merge conflict in README.md
>>> Automatic merge failed; fix conflicts and then commit the result.

A ferramenta de mesclagem Meld identificará os arquivos conflitantes e os mostrará no aplicativo Meld GUI.   

git mergetool

>>> Merging:
>>> README.md

>>> Normal merge conflict for 'README.md':
>>>   {local}: modified file
>>>   {remote}: modified file

Há três colunas: README_LOCAL_473.md, README.md, e README_LOCAL_473.md. Se você achar que as alterações remotas são válidas, clique na seta preta na coluna remota; e se quiser que as alterações locais persistam, clique na seta preta na coluna local. É simples assim. 

Conflito resolvido usando a ferramenta de mesclagem Meld

Depois de fazer as alterações, salve o arquivo e faça o commit. Como você pode ver, o envio de um arquivo para um servidor remoto não gera um erro de conflito de mesclagem.

git commit -am "remote main branch conflict resolved"
git push

>>> Enumerating objects: 16, done.
>>> Counting objects: 100% (16/16), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (10/10), 1.08 KiB | 550.00 KiB/s, done.
>>> Total 10 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), completed with 1 local object.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>    49b7d14..8f5c3aa  main -> main

Resolvemos com sucesso os conflitos de mesclagem locais e remotos. Esses conflitos são tratados diariamente por cientistas de dados e engenheiros de machine learning. Para aprimorar suas habilidades nas operações do Git, faça um curso de Introdução ao Git. 

Conclusão

A resolução de conflitos de mesclagem do Git é uma tarefa complexa e altamente arriscada, pois você pode quebrar o software mesclando códigos defeituosos. As ferramentas de mesclagem oferecem um ambiente fácil de usar com uma maneira mais segura de detectar e resolver conflitos de mesclagem. Neste tutorial, você aprendeu por que ocorrem conflitos no Git e como resolvê-los. Também abordamos vários tipos de mesclagem e conflito, comandos úteis do Git e ferramentas visuais. Na seção final, criamos um conflito de mesclagem e o resolvemos em um repositório local e remoto. 

Se você é novo no Git e quer saber como ele funciona, leia: Tutorial de introdução ao Git e ao GitHub.