Resolver conflitos de mesclagem

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

Visual Studio 2019 | Visual Studio 2022

Quando você mesclar ou rebasear, você 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.

Pré-requisitos

Categoria	Requerimentos
Acesso ao projeto	Membro de um projeto .
Permissões	- Ver código em projetos privados: Acesso pelo menos Básico. - Clone ou contribua para o código em projetos privados: Membro do grupo de segurança Contributors ou permissões correspondentes no projeto. - Definir permissões de ramo ou repositório: Gerir permissões para o ramo ou repositório. - Alterar ramificação padrão: Editar políticas e permissões para o repositório. - Importar um repositório: Membro do grupo de segurança Administradores de Projeto ou com permissão de Criar repositório ao nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços	Repos ativado.
Ferramentas	Opcional. Utilize os comandos az repos: Azure DevOps CLI.

Observação

Em projetos públicos, os usuários com acesso Partes Interessadas têm acesso total aos repositórios do Azure, incluindo visualização, clonagem e contribuição para o código.

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). O Git mesclar executa uma de avanço rápido ou uma de avanço rápido mesclagem. A fusão sem avanço rápido também é conhecida como uma fusão de três vias ou fusão verdadeira. Git rebase é outro tipo de fusão. Esses tipos de mesclagem são mostrados no diagrama a seguir.

Para a mesclagem do 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 rápida. Caso contrário, o tipo de mesclagem padrão será uma mesclagem sem avanço rápido.

Uma mesclagem de 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 de gera uma nova ramificação de destino de "confirmação de mesclagem" 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 o último commit comum a ambas as branches. No diagrama anterior, o commit C é o último commit comum em ambos os ramos. 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 de da sua ramificação, uma confirmação de mesclagem é um marcador útil para uma operação de mesclagem e mostra claramente quais ramificações foram mescladas.

O Git rebase 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, o commit C é o último commit comum em ambos os ramos. 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 estratégias de mesclagem do Git.

Quando resolver conflitos de mesclagem

Os de mesclagem do Git e os de rebase do Git são amplamente usados 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 ramificação main local atualizada com sua contraparte remota, puxando periodicamente para buscar e mesclar confirmações remotas.
2. Integre as atualizações da ramificação local main na sua ramificação de funcionalidades local usando um rebase ou merge.
3. Faça backup de seu trabalho na ramificação de recurso local empurrando- para a ramificação remota correspondente.
4. Após a conclusão da funcionalidade, crie um pedido pull para mesclar a sua ramificação de funcionalidade remota 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 mesclagem

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.

Sugestão

Se a ramificação de origem for uma ramificação de rastreamento remoto, certifique-se de que a ramificação esteja up-to-date executando um de busca de 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> em <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 Git Changes 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 de ramificação de origem, o painel atual mostra a versão do arquivo de ramificação de destino e o painel de 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 Fusão após resolver todos os conflitos de fusão 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 alteração preparada para concluir a mesclagem, depois de resolver todos os conflitos de mesclagem de todos os arquivos.

   

Visual Studio 2019 - Menu do 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, altere para a 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> em <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 Git Changes 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 de ramificação de origem, o painel atual mostra a versão do arquivo de ramificação de destino e o painel de 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 Fusão depois de resolver todos os conflitos de fusão no ficheiro 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 de usuário do Team Explorer Git. Para usar Team Explorer, desmarque Ferramentas>Opções>Funcionalidades de Pré-visualização>Nova experiência do utilizador 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 de Team Explorer, aceda à ramificação de destino. Em seguida, clique com o botão direito do mouse na ramificação de origem e escolha Efetuar Mesclagem 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 a visualização Resolver Conflitos.

   

4. A vista 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 origem mostra a versão do arquivo de ramificação de origem, o painel de destino mostra a versão do arquivo de ramificação de destino e o painel de 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 de resultados . Escolha Aceitar Mesclagem depois de resolver todos os conflitos de mescla no ficheiro 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 vista Resolver Conflitos, escolha Confirmar Mesclagem depois de resolver todos os conflitos de mesclagem para todos os arquivos.

   

9. Na vista Alterações de Team Explorer, insira uma mensagem de confirmação e escolha Confirmar Etapas para concluir a fusão.

   

Linha de comando Git

Antes de fundir uma ramificação de origem numa 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>

Sugestão

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

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

Mensagem Git	Descrição	Resolução
Suas alterações locais nos seguintes ficheiros seriam substituídas por fusão...	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.	Confirmar, armazenar ou descartar 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 --abortou resolva todos os conflitos de mesclagem e execute git merge --continue.

Sugestão

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. Executa git add <filename> para estagear o ficheiro assim que resolveres o texto conflituoso.

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

Resolver conflitos de ficheiros eliminados e modificados

Um conflito entre arquivo apagado e modificado ocorre quando o mesmo arquivo é editado numa ramificação, mas apagado noutra. 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 nos repositórios Git? Mais informações
• Atualizar código com busca, mesclagem e pull
• Guarde o seu trabalho com commits