Atualizar código com busca, mesclagem e pull

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Quando houver vários colaboradores para um projeto, mantenha seu repositório Git local atualizado baixando e integrando o trabalho que outras pessoas carregaram no repositório remoto do projeto. Estes comandos do Git atualizam seu repositório local:

• A busca do Git baixa as novas confirmações que outras pessoas carregaram no repositório remoto. As ramificações de acompanhamento remoto no cache de repositório local são atualizadas. As ramificações locais permanecem inalteradas.
• A mesclagem do Git integra confirmações de um ou mais branches de origem em um branch de destino.
• A rebase do Git integra confirmações de um branch de origem em um branch de destino, mas usa uma estratégia diferente da mesclagem do Git.
• O pull do Git executa uma busca e, em seguida, uma mesclagem ou rebase para integrar confirmações buscadas ao branch local atual.

O Visual Studio usa um subconjunto desses comandos git ao sincronizar seu repositório local com um repositório remoto.

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

Este artigo fornece procedimentos para as seguintes tarefas:

• Baixar alterações com fetch
• Atualizar branches com mesclagem ou rebase
• Baixar alterações e atualizar branches com pull

Baixar alterações com fetch

O Git fetch baixa confirmações de branch remoto e objetos de arquivo referenciados que não existem em seu repositório local e atualiza os branches de acompanhamento remoto no cache de repositório local. Os branches de acompanhamento remoto são cópias somente leitura em cache locais de branches remotos e não são suas ramificações locais. A busca do Git não atualiza seus branches locais. Por exemplo, se um repositório remoto designado por origin um branch tiver um bugfix3 branch, o Git fetch atualizará o branch de acompanhamento remoto nomeado origin/bugfix3 e não o branch local bugfix3 . Você pode usar branches de acompanhamento remoto para:

• Compare um branch de acompanhamento remoto com uma ramificação local para examinar as alterações buscadas.
• Mesclar um branch de acompanhamento remoto em uma ramificação local.
• Crie uma nova ramificação local a partir de um branch de acompanhamento remoto.

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 os 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 obter mais informações, consulte a guia Visual Studio 2019 – Team Explorer .

1. Na janela Alterações do Git , escolha Buscar. Em seguida, selecione saída/entrada para abrir a janela do Repositório Git .

   

   Você também pode escolher Buscar no menu Git.

   

2. Na janela repositório Git , as confirmações buscadas aparecem na seção Entrada . Selecione uma confirmação buscada para ver a lista de arquivos alterados nessa confirmação. Selecione um arquivo alterado para ver uma exibição diferida do conteúdo alterado.

   

Dica

O Fetch não excluirá branches de acompanhamento remoto no cache de repositório local que não têm mais um equivalente remoto. Para configurar o Visual Studio para podar branches de acompanhamento remoto obsoletos durante um Fetch:

• Selecione AsConfigurações Globais do Git de Controle > doCódigo-Fontede> de >.
• Defina os branches remotos prune durante a opção de busca como True.

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 os menus de contexto no Gerenciador de Soluções.

1. Na janela Alterações do Git , escolha Buscar. Em seguida, selecione saída/entrada para abrir a janela do Repositório Git .

   

   Você também pode escolher Buscar no menu Git.

   

2. Na janela repositório Git , as confirmações buscadas aparecem na seção Entrada . Selecione uma confirmação buscada para ver a lista de arquivos alterados nessa confirmação. Selecione um arquivo alterado para ver uma exibição diferida do conteúdo alterado.

   

Dica

O Fetch não excluirá branches de acompanhamento remoto no cache de repositório local que não têm mais um equivalente remoto. Para configurar o Visual Studio para podar branches de acompanhamento remoto obsoletos durante um Fetch:

• Selecione AsConfigurações Globais do Git de Controle > doCódigo-Fontede> de >.
• Defina os branches remotos prune durante a opção de busca como True.

Visual Studio 2019 – Team Explorer

O Visual Studio 2019 versão 16.8 e versões posteriores fornecem uma experiência de controle de versão do Git, mantendo a interface do usuário do Git do Team Explorer . Para usar o Team Explorer, desmarque aexperiência do novo usuário do Git dos recursos > devisualizaçãode> de > na barra de menus. Você pode usar recursos do Git de qualquer interface intercambiável.

1. No Team Explorer, selecione Página Inicial e, em seguida, escolha Sincronizar para abrir o modo de exibição sincronização .

   

2. No modo de exibição Sincronização , escolha Buscar. Ambos os botões fetch fazem a mesma coisa. Quando baixado, as confirmações buscadas serão exibidas na seção Confirmações de Entrada .

   

3. Na seção Confirmações de Entrada , clique com o botão direito do mouse em uma confirmação e escolha Exibir Detalhes de Confirmação para ver os arquivos alterados.

   

4. Na janela Confirmar Detalhes , os arquivos alterados são listados na seção Alterações .

   

   Clique duas vezes em um arquivo alterado para abrir uma exibição dif de conteúdo alterado.

   

Dica

O Fetch não excluirá branches de acompanhamento remoto no cache de repositório local que não têm mais um equivalente remoto. Para configurar o Visual Studio para podar branches de acompanhamento remoto obsoletos durante um Fetch:

• Selecione AsConfigurações Globais do Git de Controle > doCódigo-Fontede> de >.
• Defina os branches remotos prune durante a opção de busca como True.

Linha de Comando do Git

Para baixar novas confirmações de um branch remoto específico, execute o comando de busca do Git:

git fetch <remote repo> <remote branch name>

Para executar a busca do Git para todos os branches remotos, use:

git fetch <remote repo>

Quando você clona um repositório remoto, o Git atribui o alias origin como abreviação para a URL do repositório remoto clonado. Execute git remote -v para verificar o valor do origin alias. Para adicionar o alias origin manualmente, execute git remote add origin <remote repo url>. Com o alias origin , você pode simplificar o comando de busca do Git para:

git fetch

Para obter mais informações sobre as opções de busca do Git, consulte o manual de referência do Git.

Observação

Por padrão, a busca do Git não excluirá branches de acompanhamento remoto em seu cache de repositório local que não têm mais um equivalente remoto. Para remover branches de rastreamento remoto obsoletos, execute a busca do Git com o sinalizador ou configure o --pruneGit para podar branches de acompanhamento remoto durante a busca do Git.

Após uma busca do Git, você pode comparar uma ramificação local com seu branch de acompanhamento remoto correspondente para ver o que foi alterado no branch remoto. Se você decidir atualizar seu branch local atual com alterações buscadas, poderá executar uma mesclagem ou rebase do Git. Ou você pode executar o pull do Git, que combina uma busca do Git com uma mesclagem ou rebase do Git. A mesclagem do Git e a rebase do Git atualizam um branch de destino aplicando confirmações de um branch de origem nele. No entanto, a mesclagem do Git e a rebase do Git usam estratégias diferentes. Para obter mais informações, consulte Atualizar branches com mesclagem ou rebase e Quando rebasear versus mesclar.

Atualizar branches com mesclagem ou rebase

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

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 branch de bugfix, é uma prática comum:

1. Mantenha sua ramificação local main atual com seu equivalente remoto puxando periodicamente para buscar e mesclar confirmações remotas.
2. Integre as atualizações de ramificação local main ao branch de recursos local usando uma rebase ou mesclagem.
3. Faça backup do seu trabalho no branch de recursos 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 seu branch de recursos remoto no branch remoto main .

Essa abordagem ajuda você a:

• Lembre-se do trabalho recente de outras pessoas que podem afetar seu trabalho.
• Resolva prontamente quaisquer conflitos entre seu trabalho e o de outras pessoas.
• Aplique seu novo recurso sobre up-toconteúdo do projeto de data.
• Obtenha uma revisão de solicitação de pull do seu trabalho.

Merge

Para a mesclagem do Git, se a ponta do branch de destino existir dentro do branch 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 rápida do Git nunca pode ter um conflito de mesclagem porque o Git não aplicará uma mesclagem rápida se a ponta do branch de destino tiver divergido do branch de origem. Por padrão, o Git usa uma mesclagem rápida 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 puxando de seu branch de equivalente remoto.

Uma mesclagem git sem avanço 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 de branch 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, 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 ramificação de origem e de destino (K e E) são os pais da confirmação de mesclagem. No histórico de confirmação do branch, uma confirmação de mesclagem é um marcador útil para uma operação de mesclagem e mostra claramente quais branches foram mesclados.

A mesclagem do Git modifica 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 você pode cancelar a operação de mesclagem e retornar o branch de destino ao estado anterior.

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

Dica

Se o branch de origem for um branch de acompanhamento remoto, verifique se o branch está up-to-date executando uma busca do Git antes da mesclagem.

Visual Studio 2022

1. Escolha o Git > Gerenciar Branches na barra de menus para abrir a janela do Repositório Git .

   

2. Na janela repositório Git , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Mesclar <o branch> de origem no <branch de destino>.

   

4. O Visual Studio exibirá uma mensagem de confirmação após uma mesclagem bem-sucedida.

   

   Se a mesclagem for interrompida devido a conflitos de mesclagem, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Visual Studio 2019 – menu Git

1. Escolha o Git > Gerenciar Branches na barra de menus para abrir a janela do Repositório Git .

   

2. Na janela repositório Git , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Mesclar <o branch> de origem no <branch de destino>.

   

4. O Visual Studio exibirá uma mensagem de confirmação após uma mesclagem bem-sucedida.

   

   Se a mesclagem for interrompida devido a conflitos de mesclagem, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Visual Studio 2019 – Team Explorer

1. No Team Explorer, selecione Página Inicial e escolha Branches.

   

2. No modo de exibição Branches , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Mesclar.

   

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

   

5. O Visual Studio exibirá uma mensagem de confirmação após uma mesclagem bem-sucedida.

   

   Se houver conflitos durante a mesclagem, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Linha de Comando do Git

Para integrar confirmações de um ou mais branches de origem ao branch local atual, execute o seguinte comando de mesclagem do Git. Para vários branches de origem, separe seus nomes com espaços.

git merge <source branch name>

O Git notificará você se houver conflitos durante a mesclagem. Você pode resolver os conflitos e, em seguida, executar git merge --continueou executar git merge --abort para desfazer a mesclagem e retornar ao estado de pré-mesclagem.

Rebase

O Git rebase reentança 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 de branch de destino desde a última confirmação comum. Outra maneira de exibi-lo é que uma rebase git reproduza as alterações em seu branch de destino na parte superior do histórico do branch 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. A rebase do Git não cria uma confirmação de mesclagem. Notavelmente, a rebase do Git altera a sequência de confirmações de branch 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 uma nova ID de confirmação porque ele é vinculado novamente ao commit E em vez de C.

A rebase do Git modifica 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 rebase. Ou você pode cancelar a operação de rebase e retornar o branch de destino ao estado anterior.

Se você for a única pessoa trabalhando em seu recurso ou branch de bugfix, considere usar a rebase do Git para integrar novas main confirmações de branch a ele. Caso contrário, use a mesclagem do Git. Para obter mais informações sobre a rebase do Git e quando usá-lo, consulte Aplicar alterações com rebase e Rebase vs merge.

Dica

Se o branch de origem for um branch de acompanhamento remoto, verifique se o branch está up-to-date executando uma busca do Git antes da rebase.

Visual Studio 2022

1. Escolha o Git > Manage Branches para abrir a janela do Repositório Git .

   

2. Na janela repositório Git , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Rebase <target-branch> no <branch> de origem.

   

4. O Visual Studio exibirá uma mensagem de confirmação após uma rebase bem-sucedida.

   

   Se a rebase for interrompida devido a conflitos de mesclagem, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a rebase e retornar ao estado de pré-rebase.

   

Visual Studio 2019 – menu Git

1. Escolha o Git > Manage Branches para abrir a janela do Repositório Git .

   

2. Na janela repositório Git , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Rebase <target-branch> no <branch> de origem.

   

4. O Visual Studio exibirá uma mensagem de confirmação após uma rebase bem-sucedida.

   

   Se a rebase for interrompida devido a conflitos de mesclagem, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a rebase e retornar ao estado de pré-rebase.

   

Visual Studio 2019 – Team Explorer

1. No Team Explorer, selecione Página Inicial e escolha Branches.

   

2. No modo de exibição Branches , clique com o botão direito do mouse no branch de destino e selecione Checkout.

   

3. Clique com o botão direito do mouse no branch de origem e selecione Rebase Onto.

   

4. Verifique as opções de rebase e clique em Rebase.

   

5. O Visual Studio exibirá uma mensagem de confirmação após uma rebase bem-sucedida.

   

   Se houver conflitos durante a rebase, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a rebase e retornar ao estado de pré-rebase.

   

Linha de Comando do Git

Para integrar as confirmações de um branch de origem a um branch de destino, execute o comando de rebase do Git:

git rebase <source branch name> <target branch name>

Se o branch local atual for o branch de destino, você poderá simplificar o comando de rebase do Git para:

git rebase <source branch name>

O Git notificará você se houver conflitos durante a rebase. Você pode resolver os conflitos e, em seguida, executar git rebase --continue, ou executar git rebase --abort para desfazer a rebase e retornar ao estado de pré-rebase.

Baixar alterações e atualizar branches com pull

Por padrão, o pull do Git combina uma busca do Git e uma mesclagem do Git para atualizar seu branch local atual de seu equivalente remoto. Opcionalmente, o pull do Git pode executar uma rebase git em vez de uma mesclagem do Git.

Ao contrário do git fetch, o pull do Git atualizará seu branch local atual imediatamente após o download de novas confirmações do repositório remoto. Use o pull do Git quando souber que deseja atualizar seu branch local atual logo após uma busca do Git.

Dica

Para configurar o Visual Studio para se basear novamente em vez de mesclar quando você efetuar pull:

1. No menu Git, acesse AsConfigurações Globais do Git de Controle > doCódigo-Fontedas> de >.
2. Defina a ramificação local Rebase ao puxar a opção para True.

Visual Studio 2022

1. Na janela Alterações do Git , escolha Pull.

   

   Você também pode escolher Pull no menu Git.

   

2. Uma mensagem de confirmação é exibida quando a operação de pull é concluída.

   

   Se houver conflitos durante a parte de mesclagem da operação de pull, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Observação

No Visual Studio, a Sincronização executa um Pull e, em seguida, um Push para sincronizar um branch local e remoto. Para obter mais informações sobre Sincronização, consulte Usar o git fetch, pull, push e sincronização para controle de versão no Visual Studio.

Visual Studio 2019 – menu Git

1. Na janela Alterações do Git , escolha Pull.

   

   Você também pode escolher Pull no menu Git.

   

2. Uma mensagem de confirmação é exibida quando a operação de pull é concluída.

   

   Se houver conflitos durante a parte de mesclagem da operação de pull, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Observação

No Visual Studio, a Sincronização executa um Pull e, em seguida, um Push para sincronizar um branch local e remoto. Para obter mais informações sobre Sincronização, consulte Usar o git fetch, pull, push e sincronização para controle de versão no Visual Studio.

Visual Studio 2019 – Team Explorer

1. No Team Explorer, selecione Página Inicial e escolha Sincronizar para abrir o modo de exibição sincronização .

   

2. No modo de exibição Sincronização , escolha Pull. Ambos os botões de pull fazem a mesma coisa.

   

3. O Visual Studio exibirá uma mensagem de confirmação quando a operação de pull for concluída.

   

   Se houver conflitos durante a parte de mesclagem da operação de pull, o Visual Studio notificará você. Você pode resolver os conflitos ou cancelar a mesclagem e retornar ao estado de pré-mesclagem.

   

Observação

No Visual Studio, a Sincronização executa um Pull e, em seguida, um Push para sincronizar um branch local e remoto. Para obter mais informações sobre Sincronização, consulte Usar o git fetch, pull, push e sincronização para controle de versão no Visual Studio.

Linha de Comando do Git

Para usar a busca e a integração de confirmações de um branch remoto ao branch de trabalho atual, execute o comando de pull do Git:

git pull <remote repo> <remote branch name>

Se o repositório remoto tiver um branch com o mesmo branch de nome do branch de trabalho atual, você poderá simplificar o comando pull do Git para:

git pull <remote repo>

Quando você clona um repositório remoto, o Git atribui o alias origin como abreviação para a URL do repositório remoto clonado. Execute git remote -v para verificar o valor do origin alias. Para adicionar o alias origin manualmente, execute git remote add origin <remote repo url>. Com o alias origin , você pode simplificar ainda mais o comando pull do Git para:

git pull

Para usar uma estratégia de rebase para integrar confirmações de um branch remoto ao branch de trabalho atual, execute o comando pull do Git com o --rebase sinalizador. Para obter mais informações sobre as opções de pull do Git, consulte o manual de referência do Git.

Dica

O Git notificará você se houver conflitos durante a parte de mesclagem/rebase da operação de pull do Git. Em seguida, você pode resolver os conflitos e, em seguida, executar git merge --continue ou git rebase --continueexecutar git merge --abort ou git rebase --abort desfazer a mesclagem/rebase.

Próximas etapas

Compartilhar código com o pushResolver conflitos de mesclagem

Artigos relacionados

• Novo para repositórios Git? Saiba Mais