Resolver conflitos de intercalação

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Quando você mescla ou rebaseia, está dizendo ao Git para integrar as alterações feitas em uma ramificação com as alterações feitas em outra. Muitas vezes, o Git conclui uma mesclagem ou rebase automaticamente sem a sua ajuda. No entanto, se o Git descobrir que uma alteração feita em uma ramificação está em conflito com uma alteração feita em outra, ele solicitará que você resolva o conflito. Um conflito de mesclagem pode ocorrer quando as ramificações mescladas editam a mesma linha de arquivo de forma diferente ou quando uma ramificação modifica um arquivo e outra ramificação o exclui. O processo de resolução de conflitos de mesclagem é aplicável tanto à mesclagem quanto à rebase 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 o tutorial do Azure Repos Git.

Este artigo fornece procedimentos para as seguintes tarefas:

• Compreender os conflitos de mesclagem
• Resolver conflitos de intercalação

Compreender os conflitos de mesclagem

A mesclagem ou rebase do Git integra confirmações de uma ramificação de origem à sua ramificação local atual (ramificação de destino). A mesclagem do Git executa uma mesclagem de avanço rápido ou de avanço rápido. A mesclagem sem avanço rápido também é conhecida como mesclagem de três vias ou mesclagem verdadeira . Git rebase é outro tipo de fusão. Esses tipos de mesclagem são mostrados no diagrama a seguir.

Para mesclagem Git, se a ponta da ramificação de destino existir dentro da ramificação de origem, o tipo de mesclagem padrão será uma mesclagem de avanço rápido. Caso contrário, o tipo de mesclagem padrão será uma mesclagem sem avanço rápido.

Uma mesclagem de avanço rápido nunca pode ter um conflito de mesclagem porque o Git não aplicará uma mesclagem de avanço rápido se a ponta da ramificação de destino tiver divergido da ramificação de origem. Por padrão, o Git usa uma mesclagem de avanço rápido sempre que possível. Por exemplo, o Git aplicará uma mesclagem de avanço rápido em uma ramificação local que você só atualiza extraindo de sua ramificação homóloga remota.

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

A rebase do Git resequencia o histórico de confirmações da ramificação de destino para que ela contenha todas as confirmações de ramificação de origem, seguidas por todas as confirmações de ramificação de destino desde a última confirmação comum. No diagrama anterior, a confirmação C é a última confirmação comum em ambas as ramificações. Outra maneira de visualizá-lo é que uma rebase reproduz as alterações na ramificação de destino sobre o histórico da ramificação de origem. Se qualquer alteração de ramificação de origem entrar em conflito com qualquer alteração de ramificação de destino, o Git solicitará que você resolva o conflito de mesclagem. Assim como acontece com a mesclagem rápida, uma rebase não cria uma confirmação de mesclagem. Notavelmente, uma rebase altera a sequência das confirmações de 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 de commit porque ele se vincula de volta para commit E em vez de C.

A mesclagem e a rebase do Git modificam apenas a ramificação de destino — a ramificação de origem permanece inalterada. Quando você encontrar um ou mais conflitos de mesclagem, deverá resolvê-los para concluir a mesclagem ou a rebaseação. Ou, você pode cancelar a operação de mesclagem/rebase e retornar a ramificação de destino ao seu 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 rebase do Git são amplamente usadas no fluxo de trabalho do Git. Ao trabalhar em um recurso local ou ramificação de correção de bugs, é prática comum:

1. Mantenha sua filial local main atualizada com sua contraparte remota, puxando periodicamente para buscar e mesclar confirmações remotas.
2. Integre atualizações de ramificação local main em sua ramificação de recurso local usando uma rebase ou mesclagem.
3. Faça backup de seu trabalho na ramificação de recurso local enviando-a para a ramificação remota correspondente.
4. Após a conclusão do recurso, crie uma solicitação pull para mesclar sua ramificação de recurso remoto na ramificação remota main .

Ao integrar frequentemente alterações remotas em seu repositório local, você pode ficar ciente do trabalho recente de outras pessoas e resolver prontamente quaisquer conflitos de mesclagem que surjam.

Resolver conflitos de intercalação

O processo de resolução de conflitos de mesclagem é aplicável tanto à mesclagem do Git quanto à rebase do Git. Embora as etapas a seguir descrevam como resolver conflitos de mesclagem durante uma mesclagem, você também pode resolver conflitos de mesclagem durante uma rebase.

Gorjeta

Se a ramificação de origem for uma ramificação de rastreamento remoto, certifique-se de que a ramificação esteja atualizada executando uma busca Git antes de uma mesclagem. Ou execute o comando 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, Alterações do Git e por meio de menus de contexto no Gerenciador de Soluções. O Visual Studio 2019 versão 16.8 também oferece a interface de usuário do Team Explorer Git. Para obter mais informações, consulte a guia Visual Studio 2019 - Team Explorer .

1. No painel Ramificações da janela Repositório Git, faça checkout da ramificação de destino. Em seguida, clique com o botão direito do mouse na ramificação de origem e escolha Mesclar <ramificação> de origem na <ramificação> de destino.

   

2. O Visual Studio irá notificá-lo se o Git interrompeu a mesclagem devido a conflitos. Nesse caso, 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 Entrada mostra a versão do arquivo de ramificação de origem, o painel Atual mostra a versão do arquivo de ramificação de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas na ramificação de origem ou de destino, marque a caixa de seleção ao lado da(s) linha(s) conflitante(s) 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 uma ramificação e excluído na outra, clique com o botão direito do mouse no arquivo e selecione qual ação de ramificação você deseja.

   

5. Na janela Alterações do Git, insira uma mensagem de confirmação e escolha Confirmar em estágios para concluir a mesclagem, depois de resolver todos os conflitos de mesclagem de 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, Alterações do Git e por meio de menus de contexto no Gerenciador de Soluções.

1. No painel Ramificações da janela Repositório Git, faça checkout da ramificação de destino. Em seguida, clique com o botão direito do mouse na ramificação de origem e escolha Mesclar <ramificação> de origem na <ramificação> de destino.

   

2. O Visual Studio irá notificá-lo se o Git interrompeu a mesclagem devido a conflitos. Nesse caso, 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 Entrada mostra a versão do arquivo de ramificação de origem, o painel Atual mostra a versão do arquivo de ramificação de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas na ramificação de origem ou de destino, marque a caixa de seleção ao lado da(s) linha(s) conflitante(s) 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 uma ramificação e excluído na outra, clique com o botão direito do mouse no arquivo e selecione qual ação de ramificação você deseja.

   

5. Na janela Alterações do Git, insira uma mensagem de confirmação e escolha Confirmar em estágios para concluir a mesclagem, depois de resolver todos os conflitos de mesclagem de todos os arquivos.

   

Visual Studio 2019 - Explorador de Equipa

O Visual Studio 2019 versão 16.8 e versões posteriores fornece uma experiência de controle de versão do Git enquanto mantém a interface do usuário do Team Explorer Git. Para usar o Team Explorer, desmarque Ferramentas>Opções>Visualizar recursos>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 visualização Ramificações do Team Explorer, faça checkout da ramificação de destino. Em seguida, clique com o botão direito do mouse na ramificação de origem e escolha Mesclar de.

   

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

   

3. O Visual Studio irá notificá-lo se o Git interrompeu a mesclagem devido a conflitos. Nesse caso, você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem. Para resolver conflitos, escolha Conflitos para abrir o modo de exibição Resolver Conflitos.

   

4. O modo de 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 Origem mostra a versão do arquivo de ramificação de origem, o painel Destino mostra a versão do arquivo de ramificação de destino e o painel Resultado mostra o arquivo de mesclagem resultante. Para aplicar alterações específicas na ramificação de origem ou de destino, marque a caixa de seleção ao lado da(s) linha(s) conflitante(s) 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 uma ramificação e excluído na outra, selecione qual ação de ramificação você deseja.

   

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

   

9. Na visualização Alterações do Team Explorer, insira uma mensagem de confirmação e escolha Confirmar em etapas para concluir a mesclagem.

   

Linha de comando Git

Antes de mesclar uma ramificação de origem em uma ramificação de destino, faça checkout da ramificação de destino. Em seguida, use o comando Git merge para mesclar a ramificação de origem na ramificação local atual (ramificação de destino). Para mesclar várias ramificações de origem em uma ramificação de destino, separe os nomes de ramificação de origem com espaços.

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

Gorjeta

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

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

Mensagem Git	Description	Resolução
Suas alterações locais nos seguintes arquivos seriam substituídas por mesclagem...	Esse erro indica que sua ramificação 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.	Confirme, armazene ou descarte as alterações não confirmadas e, em seguida, tente novamente a mesclagem.
Falha na mesclagem automática; corrigir conflitos e, em seguida, confirmar o resultado.	Pelo menos uma alteração de ramificação de origem entra em conflito com uma alteração de ramificação de destino. O Git interrompe a mesclagem e espera 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.

Gorjeta

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 as confirmações conflitantes nas ramificações de origem e de destino.

Resolver conflitos de conteúdo de arquivo

1. Abra um arquivo em qualquer editor para visualizar e resolver o texto conflitante. O Git adicionou um conjunto de marcadores para indicar ocorrências de texto conflitantes. 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 de ramificação de destino do texto conflitante.
   O texto entre ======= e >>>>>>> é a versão de ramificação de origem do texto conflitante.

2. Edite o arquivo para resolver o texto conflitante. Ao remover os marcadores de conflito de mesclagem, você informa 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 arquivos modificados excluídos

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

Próximos passos

Compartilhar código com pushDesfazer alterações

Artigos relacionados

• Novo no Git repos? Mais informações
• Atualizar código com busca, mesclagem e pull
• Salve seu trabalho com confirmações