Resolver conflitos de mesclagem

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Ao mesclar ou trocar base, você está dizendo ao Git para integrar as alterações feitas em um branch com alterações feitas em outro. Muitas vezes, o Git conclui uma mesclagem ou troca de base automaticamente sem sua assistência. No entanto, se o Git descobrir que uma alteração feita em um branch que está em conflito com uma alteração feita em outro, ele solicitará que você resolva o conflito. Um conflito de mesclagem pode ocorrer quando os branches mesclados editam a mesma linha de arquivo de forma diferente ou quando um branch modifica um arquivo e outro branch o exclui. O processo para resolver conflitos de mesclagem é aplicável à mesclagem e à troca de base do Git.

Você pode resolver conflitos de mesclagem no Visual Studio ou usando a linha de comando e qualquer editor de texto.

Para obter uma visão geral do fluxo de trabalho do Git, consulte Tutorial do Git do Azure Repos.

Este artigo fornece procedimentos para as seguintes tarefas:

• Entender conflitos de mesclagem
• Resolver conflitos de mesclagem

Entender conflitos de mesclagem

A mesclagem ou troca de base do Git integra commits de uma ramificação de origem em sua ramificação local atual (ramificação de destino). A mesclagem do Git executa uma mesclagem de encaminhamento rápido ou sem encaminhamento rápido. A mesclagem sem encaminhamento rápido também é conhecida como mesclagem three-way ou mesclagem true. A troca de base do Git é outro tipo de mesclagem. Esses tipos de mesclagem são mostrados no diagrama a seguir.

Para a mesclagem do Git, se a dica do branch de destino existir no branch de origem, o tipo de mesclagem padrão será uma mesclagem de encaminhamento rápido. Caso contrário, o tipo de mesclagem padrão será uma mesclagem sem encaminhamento rápido.

Uma mesclagem encaminhamento rápido nunca pode ter um conflito de mesclagem porque o Git não aplicará uma mesclagem de encaminhamento rápido se a dica do branch de destino tiver divergido do branch de origem. Por padrão, o Git usa uma mesclagem de encaminhamento rápido sempre que possível. Por exemplo, o Git aplicará uma mesclagem de encaminhamento rápido em um branch local que você atualiza apenas fazendo pull de seu branch de equivalente remoto.

Uma mesclagem sem encaminhamento rápido gera uma nova "confirmação de mesclagem" do branch de destino que integra as alterações do branch de origem com as alterações do branch de destino. As alterações aplicáveis são aquelas feitas após a última confirmação que é comum a ambos os branches. No diagrama anterior, commit C é a última confirmação comum em ambos os branches. Se qualquer alteração de branch de origem entrar em conflito com qualquer alteração de branch de destino, o Git solicitará que você resolva o conflito de mesclagem. A confirmação de mesclagem (L) contém o branch de origem integrado e as alterações de branch de destino. As dicas de branch de origem e de destino (K e E) são os pais da confirmação de mesclagem. No histórico de commits do branch, uma confirmação de mesclagem é um marcador útil para uma operação de mesclagem e mostra claramente quais branches foram mesclados.

A troca de base do Git sequencia novamente o histórico de confirmação do branch de destino para que ele contenha todas as confirmações do branch de origem, seguido por todas as confirmações do branch de destino desde a última confirmação comum. No diagrama anterior, commit C é a última confirmação comum em ambos os branches. Outra maneira de exibi-lo é que uma troca de base reproduz as alterações na ramificação de destino sobre o histórico da ramificação de origem. Se qualquer alteração de branch de origem entrar em conflito com qualquer alteração de branch de destino, o Git solicitará que você resolva o conflito de mesclagem. Assim como acontece com a mesclagem de encaminhamento rápido, uma troca de base não cria uma confirmação de mesclagem. Notavelmente, uma troca de base altera a sequência de commits da ramificação de destino existentes, o que não é o caso das outras estratégias de mesclagem. No diagrama anterior, commit K' contém as mesmas alterações que K, mas tem um novo ID do commit porque ele é vinculado de volta ao commit E em vez de C.

A troca de base e a mesclagem do Git modificam apenas o branch de destino. O branch de origem permanece inalterado. Ao encontrar um ou mais conflitos de mesclagem, você deve resolvê-los para concluir a mesclagem ou troca de base. Ou você pode cancelar a operação de mesclagem/troca de base e retornar o branch de destino ao estado anterior.

Para obter mais informações sobre opções e estratégias de mesclagem, consulte o manual de referência do Git e as estratégias de mesclagem do Git.

Quando resolver conflitos de mesclagem

A mesclagem do Git e a troca de base do Git são amplamente usadas no fluxo de trabalho do Git. Ao trabalhar em um recurso local ou em um branch de correção de bugs, é uma prática comum:

1. Manter seu mainbranch local atualizado com seu equivalente remoto efetuando pull periodicamente para buscar e mesclar commits remotos.
2. Integrar as atualizações de mainbranch local ao branch de recurso local usando uma troca de base ou mesclagem.
3. Faça backup do trabalho no branch de recurso local enviando-o por push para o branch remoto correspondente.
4. Após a conclusão do recurso, crie uma solicitação de pull para mesclar o branch de recurso remoto no mainbranch remoto.

Ao integrar alterações remotas com frequência ao repositório local, você pode ficar atento ao trabalho recente de outras pessoas e imediatamente resolver quaisquer conflitos de mesclagem que surgirem.

Resolver conflitos de mesclagem

O processo para resolver conflitos de mesclagem é aplicável à mesclagem do Git e à troca de base do Git. Embora as etapas a seguir descrevam como resolver conflitos de mesclagem durante uma mesclagem, você pode resolve conflitos de mesclagem durante uma troca de base.

Dica

Se o branch de origem for um branch de acompanhamento remoto, verifique se o branch está atualizado executando uma busca do Git antes de uma mesclagem. Ou execute o comando de pull do Git, que combina uma busca do Git com uma mesclagem do Git.

Visual Studio 2022

O Visual Studio 2022 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e através dos menus de contexto no Gerenciador de Soluções. O Visual Studio 2019, versão 16.8, também oferece a interface do usuário do Git do Team Explorer. Para saber mais, consulte a guia Visual Studio 2019 - Team Explorer.

1. No painel Branches da janela Repositório do Git, confira o branch de destino. Clique com o botão direito do mouse no branch de origem e selecione Mesclar<Branch de origem> em <Branch de destino>.

   

2. O Visual Studio notificará você se o Git interromper a mesclagem devido a conflitos. No evento, você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem. A seção Alterações Não Mescladas da janela Alterações do Git lista os arquivos com conflitos de mesclagem. Para um arquivo com conflitos de mesclagem em seu conteúdo, clique duas vezes no arquivo para abri-lo no editor de mesclagem.

   

3. No editor de mesclagem, o painel de Entrada mostra a versão do arquivo do branch de origem, o painel Atual mostra a versão do arquivo do branch de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas do branch de origem ou de destino, marque a caixa de seleção ao lado das linhas conflitantes que você deseja manter. Você também pode editar diretamente o arquivo de mesclagem no painel Resultado. Escolha Aceitar Mesclagem depois de resolver todos os conflitos de mesclagem no arquivo atual. Repita esta etapa para cada arquivo com conflitos de conteúdo.

   

4. Para um arquivo que foi editado em um branch e excluído no outro, clique com o botão direito do mouse no arquivo e selecione qual ação de branch você deseja.

   

5. Na janela Alterações do Git, insira um mensagem do commit e escolha Commit preparado para concluir a mesclagem - depois de resolver todos os conflitos de mesclagem para todos os arquivos.

   

Visual Studio 2019 - Menu Git

O Visual Studio 2019 fornece uma experiência de controle de versão do Git usando o menu Git, as Alterações do Git e através dos menus de contexto no Gerenciador de Soluções.

1. No painel Branches da janela Repositório do Git, confira o branch de destino. Clique com o botão direito do mouse no branch de origem e selecione Mesclar<Branch de origem> em <Branch de destino>.

   

2. O Visual Studio notificará você se o Git interromper a mesclagem devido a conflitos. No evento, você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem. A seção Alterações Não Mescladas da janela Alterações do Git lista os arquivos com conflitos de mesclagem. Para um arquivo com conflitos de mesclagem em seu conteúdo, clique duas vezes no arquivo para abri-lo no editor de mesclagem.

   

3. No editor de mesclagem, o painel de Entrada mostra a versão do arquivo do branch de origem, o painel Atual mostra a versão do arquivo do branch de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas do branch de origem ou de destino, marque a caixa de seleção ao lado das linhas conflitantes que você deseja manter. Você também pode editar diretamente o arquivo de mesclagem no painel Resultado. Escolha Aceitar Mesclagem depois de resolver todos os conflitos de mesclagem no arquivo atual. Repita esta etapa para cada arquivo com conflitos de conteúdo.

   

4. Para um arquivo que foi editado em um branch e excluído no outro, clique com o botão direito do mouse no arquivo e selecione qual ação de branch você deseja.

   

5. Na janela Alterações do Git, insira um mensagem do commit e escolha Commit preparado para concluir a mesclagem - depois de resolver todos os conflitos de mesclagem para todos os arquivos.

   

Visual Studio 2019 - Team Explorer

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git, mantendo a interface do usuário do Team Explorer Git. Para usar o Team Explorer, desmarque Ferramentas>Opções>Versão prévia do recurso>Nova experiência do usuário do Git na barra de menus. Você pode usar os recursos do Git de qualquer interface de forma intercambiável.

1. Na exibição Branches do Team Explorer, faça check-out do branch de destino. Em seguida, clique com o botão direito do mouse no branch de origem e escolha Mesclar de.

   

2. Verifique as opções de mesclagem e clique em Mesclar.

   

3. O Visual Studio notificará você se o Git interromper a mesclagem devido a conflitos. No evento, você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem. Para resolve conflitos, escolha Conflitos para abrir a exibição Resolver Conflitos.

   

4. A exibição Resolver Conflitos lista os arquivos com conflitos de mesclagem. Selecione um arquivo na lista para exibir as opções de resolução desse arquivo.

   

5. Para um arquivo com conflitos de mesclagem em seu conteúdo, selecione Mesclar para abri-lo no editor de mesclagem.

   

6. No editor de mesclagem, o painel de Fonte mostra a versão do arquivo do branch de origem, o painel Destino mostra a versão do arquivo do branch de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas do branch de origem ou de destino, marque a caixa de seleção ao lado das linhas conflitantes que você deseja manter. Você também pode editar diretamente o arquivo de mesclagem no painel Resultado. Escolha Aceitar Mesclagem depois de resolver todos os conflitos de mesclagem no arquivo atual. Repita esta etapa para cada arquivo com conflitos de conteúdo.

   

7. Para um arquivo que foi editado em um branch e excluído no outro, selecione qual ação de branch você deseja.

   

8. Na exibição Resolver Conflitos, escolha Confirmar Mesclagem depois de resolver todos os conflitos de mesclagem para todos os arquivos.

   

9. Na exibição Alterações do Team Explorer, insira uma mensagem do commit e escolha Commit preparado para concluir a mesclagem.

   

Linha de comando Git

Antes de mesclar um branch de origem em um branch de destino, faça check-out do branch de destino. Em seguida, use o comando Mesclagem do Git para mesclar o branch de origem no branch local atual (branch de destino). Para mesclar vários branches de origem em um branch de destino, separe os nomes de branch de origem com espaços.

git checkout <target branch>
git merge <source branch>

Dica

Você também pode usar git switch <branch name> para alternar para um branch.

Alguns cenários farão com que o comando Mesclagem do Git falhe com um erro ou pare antes da conclusão.

Mensagem do Git	Descrição	Resolução
Suas alterações locais nos seguintes arquivos seriam substituídas por mesclagem...	Esse erro indica que o branch local atual tem um ou mais arquivos com alterações não confirmadas e esses arquivos são afetados pela mesclagem. O Git não gerará um erro para alterações não confirmadas em arquivos que não são afetados pela mesclagem.	Commit, faça entrada stash ou descarte as alterações não confirmadas e repita a mesclagem.
Falha na mesclagem automática; corrija conflitos e confirme o resultado.	Pelo menos uma alteração de branch de origem entra em conflito com uma alteração de branch de destino. O Git interrompe a mesclagem e aguarda que você resolva os conflitos de mesclagem.	Cancele a mesclagem executando git merge --abort ou resolva todos os conflitos de mesclagem e execute git merge --continue.

Dica

Para a operação de mesclagem atual, você pode:

• Execute git status para listar os arquivos com conflitos de mesclagem.
• Execute git log --merge para listar os commits conflitantes nos branches de origem e de destino.

Resolver conflitos de conteúdo do arquivo

1. Abra um arquivo em qualquer editor para exibir e resolver o texto conflitante. O Git adicionou um conjunto de marcadores para indicar instâncias de texto conflitante. Por exemplo:

   <<<<<<< HEAD
   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switches
   =======
   - Network control
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   >>>>>>> origin/main
   

   O texto entre <<<<<<< e ======= é a versão do branch de destino do texto conflitante.
   O texto entre ======= e >>>>>>> é a versão do branch de origem do texto conflitante.

2. Edite o arquivo para resolver o texto conflitante. Ao remover os marcadores de conflito de mesclagem, você está informando ao Git que resolveu o conflito. Por exemplo, você pode alterar o texto anterior (incluindo os marcadores de conflito) para:

   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   

3. Execute git add <filename> para preparar o arquivo depois de resolver todo o texto conflitante.

4. Repita as etapas anteriores para todos os arquivos com conflitos de conteúdo.

Resolver conflitos de arquivo com modificação excluída

Um conflito de arquivo modificado excluído ocorre quando o mesmo arquivo é editado em um branch, mas excluído em outro. Para cada arquivo modificado excluído, decida com qual ação de branch você deseja usar. Em seguida, use git add <filename> para manter o arquivo modificado ou git rm <filename> para excluir o arquivo.

Próximas etapas

Compartilhar código com pushDesfazer alterações

Artigos relacionados

• Novo no Repositório do Git? Saiba mais
• Atualizar código com busca, mesclagem e pull
• Salvar seu trabalho com confirmações