Configurações e preferências do Git no Visual Studio

No Visual Studio, você pode definir e exibir configurações e preferências comuns do Git, como seu nome e endereço de email, suas ferramentas de diferenciação e mesclagem preferenciais e muito mais. Essas configurações e preferências podem ser exibidas e configuradas na caixa de diálogo Opções na página Configurações Globais do Git (aplica-se a todos os repositórios) ou na página Configurações do Repositório Git (aplica-se ao repositório atual).

Você pode definir dois tipos de configurações:

• Configurações do Git – As configurações nesta seção correspondem às configurações do Git salvas nos arquivos de configuração do Git. Essas configurações podem ser exibidas e modificadas no Visual Studio, mas são gerenciadas por arquivos de configuração do Git.
• Configurações do Visual Studio – As configurações nesta seção definem as configurações e preferências relacionadas ao Git que são gerenciadas pelo Visual Studio.

Como definir configurações

1. Para definir as configurações do Git no Visual Studio, escolha Configurações no menu Git de nível superior.

   

   

2. Escolha Configurações Globais do Git ou Configurações do Repositório Git para exibir e definir configurações de nível global ou de repositório.

   

3. Você pode definir várias configurações comuns do Git, conforme descrito nas seções a seguir deste artigo. Depois de definir as configurações desejadas, selecione OK para salvar as configurações atualizadas.

   

Configurações do Git

Você também pode definir e verificar algumas das configurações mais comuns do Git. Você pode exibir e modificar as seguintes configurações no Visual Studio, mesmo que elas sejam gerenciadas por arquivos de configuração do Git.

• Nome e email
• Remover as ramificações remotas durante a busca
• Trocar a base da ramificação local durante o pull
• provedor de rede criptográfica
• Assistente de credenciais
• Ferramentas de diferenciação e mesclagem
• Arquivos Git
• Remotos
• Outras configurações

Nome e email

O nome e o email fornecidos são usados como informações de confirmação para qualquer confirmação que você fizer. Essa configuração está disponível em escopos globais e de repositório e corresponde às git config configurações de user.name e user.email.

1. No menu Git, vá para Configurações. Para definir o nome de usuário e o email no nível global, acesse As Configurações Globais do Git; para definir o nome de usuário e o email no nível do repositório, vá para As Configurações do Repositório Git.

2. Forneça seu nome de usuário e email e escolha OK para salvar.

   

Remover as ramificações remotas durante a busca

A poda remove branches de acompanhamento remoto que não existem mais no remoto e ajuda você a manter sua lista de branches limpa e atualizada. Esta configuração está disponível no escopo global e de repositório e corresponde à configuração git configfetch.prune.

Recomendamos definir essa opção como True no nível global. As configurações válidas são, da seguinte maneira:

• True (recomendado)
• Falso
• Desativado (padrão)

Veja como alterar as configurações:

1. No menu Git, vá para Configurações. Vá para As Configurações Globais do Git para configurar essa opção no nível global; vá para As Configurações do Repositório Git para configurar essa opção no nível do repositório.

2. Defina Podar branches remotos durante a obtenção para Verdadeiro (recomendado). Selecione Ok para salvar.

   

Trocar a base do branch local durante o pull

O rebasing segrega as alterações feitas pelos commits no branch atual que não estão no branch upstream, restaura o branch atual para o branch upstream e aplica as alterações que foram separadas. Essa configuração está disponível no escopo global e de repositório e corresponde à configuração git config. As configurações válidas são, da seguinte maneira:

• True: basear novamente o branch atual na parte superior do branch upstream após a busca.

• False: mesclar o branch atual no branch upstream.

• Unset (padrão): A menos que seja especificado em outros arquivos de configuração, mescle o ramo atual no ramo upstream.

• Interativo: rebase no modo interativo.

• Mesclagens: rebasear sem achatar confirmações de mesclagem criadas localmente.

  Observação

  No Visual Studio 2022 versão 17.2, alteramos a configuração "Preservar" para "Mesclagens" para corresponder a uma atualização recente do Git. Portanto, se você estiver usando uma versão anterior do Visual Studio com ferramentas Git, sua interface do usuário pode exibir "Preservar" em vez de "Mesclagens". No entanto, a funcionalidade permanece a mesma.

Veja como alterar as configurações:

1. No menu Git, vá para Configurações. Vá para As Configurações Globais do Git para configurar essa opção no nível global; vá para As Configurações do Repositório Git para configurar essa opção no nível do repositório.

2. Defina Rebase da ramificação local ao puxar para a configuração desejada e selecione OK para salvar.

   

Não é possível configurar pull.rebase para o Interactive no Visual Studio. O Visual Studio não tem suporte de rebase interativo. Para configurar pull.rebase para usar o modo interativo, use a linha de comando.

Provedor de rede criptográfica

O provedor de rede criptográfica é uma configuração do Git no escopo global que define qual back-end TLS/SSL usar em tempo de execução e corresponde à configuração git confighttp.sslBackend. Os valores são, da seguinte maneira:

• OpenSSL: use OpenSSL para protocolos TLS e SSL.
• Canal Seguro: use o Canal Seguro (schannel) para protocolos TLS e SSL. O Schannel é a solução nativa do Windows, acessando o Windows Credential Store, permitindo assim o gerenciamento de certificados em toda a empresa.
• Unset (padrão): se essa configuração não estiver definida, OpenSSL será o padrão.

Veja como alterar as configurações:

1. No menu Git, vá para Configurações. Vá para As Configurações Globais do Git para definir essa configuração.

2. Defina o provedor de rede criptográfica com o valor desejado e selecione OK para salvar.

   

Auxiliar de credenciais

Quando o Visual Studio executa uma operação remota do Git, o ponto de extremidade remoto pode rejeitar a solicitação porque ela exige que as credenciais sejam fornecidas com a solicitação. Nesse momento, o Git invoca um auxiliar de credencial, que retorna as credenciais necessárias para executar a operação e tenta a solicitação novamente. O auxiliar de credenciais usado corresponde à configuração git configcredential.helper. Está disponível no escopo global com os seguintes valores:

• GCM para Windows: Utilize o Git Credential Manager para Windows como auxiliar.
• GCM Core: use o Git Credential Manager Core como auxiliar.
• Unset (padrão): se essa configuração não estiver definida, o auxiliar de credencial definido na configuração do sistema será usado. A partir do Git para Windows 2.29, o auxiliar de credencial padrão é o GCM Core.

Veja como alterar as configurações:

1. No menu Git, vá para Configurações. Vá para As Configurações Globais do Git para definir essa configuração.

2. Defina Auxiliar de credenciais como o valor desejado e selecione OK para salvar.

   

Ferramentas de diferenciação e mesclagem

O Git mostra diferenças e conflitos de mesclagem em suas ferramentas preferenciais. As configurações nesta seção correspondem às git config configurações diff.tool e merge.tool. Você pode configurar o Git para usar o Visual Studio como sua ferramenta de mesclagem ou diferenciação nas Configurações Globais do Git e nas Configurações do Repositório Git selecionando Usar o Visual Studio. Para configurar outras ferramentas de diferenciação e mesclagem, use git config com a opção diff.tool ou merge.tool .

Arquivos Git

Você pode usar a seção arquivos Git no escopo de Configurações do Repositório Git para exibir e editar os arquivos gitignore e gitattributes para seu repositório.

Controles remotos

Você pode usar o painel Remotos em Configurações do Repositório Git para configurar os controles remotos para o repositório. Essa configuração corresponde ao comando remoto git e permite que você adicione, edite ou remova remotos.

Outras configurações

Para exibir todas as outras configurações do Git, você pode abrir e exibir os próprios arquivos de configuração ou executar git config --list para exibir as configurações.

Configurações do Visual Studio

As configurações a seguir gerenciam as preferências relacionadas ao Git no Visual Studio e são gerenciadas pelo Visual Studio em vez de arquivos de configuração do Git. Todas as configurações nesta seção são configuradas na página Configurações Globais do Git .

Local padrão

O local padrão configura a pasta padrão na qual os repositórios são clonados.

Fechar soluções abertas que não estão no Git ao abrir um repositório

Por padrão, o Visual Studio fecha qualquer solução ou pasta aberta quando você alterna para outro repositório. Ao fazer isso, ele também poderá carregar a solução ou a pasta do novo repositório com base em se você optar por Abrir pasta no Gerenciador de Soluções ao abrir um repositório Git e carregar automaticamente a solução ao abrir um repositório Git. Essa configuração mantém a consistência entre o código aberto e o repositório aberto. No entanto, se sua solução não estiver na mesma raiz de diretório que o seu repositório, talvez você queira manter a solução aberta ao mudar para o seu repositório. Você pode fazer isso com essa configuração. Os valores são, da seguinte maneira:

• Sim: quando um repositório é aberto, a solução aberta no momento é sempre fechada

• Não: quando um repositório é aberto, o Visual Studio executa uma verificação se a solução atual está no Git. Se não estiver, a solução permanecerá aberta.

• Sempre pergunte (padrão): quando isso é definido, você pode fazer uma escolha por meio de uma caixa de diálogo por repositório aberto, quer você queira manter a solução atual aberta ou fechá-la.

  

Habilitar o download de imagens de autor de fontes de terceiros

Habilitar o download de imagens de autor de fontes de terceiros é uma configuração específica do Visual Studio no escopo global. Quando marcadas, as imagens de autor são baixadas do serviço de imagem Gravatar, se disponíveis, e exibidas nas exibições de confirmação e histórico.

Confirmar as alterações após a mesclagem por padrão

Quando Confirmar alterações após a mesclagem por padrão está habilitado, o Git cria automaticamente um novo commit quando um branch é mesclado com o branch atual.

• Quando marcados, os comandos git merge emitidos pelo Visual Studio são executados com a opção --commit.
• Quando não verificados, os comandos git merge emitidos pelo Visual Studio são executados com as opções --no-commit --no-ff.

Para obter mais informações sobre essas opções, consulte --commit e --no-commit e --no-ff.

Habilitar push --force-with-lease

Quando habilitada, essa configuração permite que você utilize push --force-with-lease dentro do Visual Studio. Por padrão, a função Ativar push --force-with-lease está desabilitada.

Para obter mais informações, consulte push --force-with-lease.

Abrir pasta no Gerenciador de Soluções ao abrir um repositório Git

Quando você usa o Visual Studio para abrir ou alternar para um repositório Git, o Visual Studio carrega o conteúdo do Git para que você possa exibir alterações, confirmações, branches e gerenciar seu repositório de dentro do IDE. Além disso, o Visual Studio também carrega o código do repositório no Gerenciador de Soluções. O Visual Studio verifica a pasta do repositório em busca de soluções, CMakeLists.txtou quaisquer outros arquivos de exibição que ele reconhece e os exibe como uma lista no Gerenciador de Soluções. A partir daí, você pode selecionar uma solução para carregar ou a pasta para exibir o conteúdo do diretório. Quando você desativa essa caixa de seleção, o Visual Studio não abre a pasta do repositório no Gerenciador de Soluções. Essa opção essencialmente permite que você abra o Visual Studio apenas como um gerenciador de repositório Git. A definição está ativada por predefinição.

Carregar automaticamente a solução ao abrir um repositório Git

Essa configuração é aplicável somente quando a pasta Abrir no Gerenciador de Soluções ao abrir uma configuração de repositório Git é ativada. Quando você abre um repositório Git no Visual Studio e a verificação de pasta subsequente detecta que há apenas uma solução presente em seu repositório e, em seguida, o Visual Studio carrega automaticamente essa solução. Se você desativar a configuração, o Gerenciador de Soluções exibirá a única solução presente no repositório na lista de exibições. Mas não carrega a solução. Por padrão, essa configuração está desativada.

Fazer check-out de ramificações automaticamente com um clique duplo ou usando a tecla Enter

A janela Repositório Git tem uma lista de ramificações exibida em uma estrutura de árvore. A seleção única de um branch alterna o painel de histórico de confirmação para exibir as confirmações do branch selecionado. Para fazer checkout de uma ramificação, clique com o botão direito do mouse para abrir o menu de contexto e selecione Checkout. Se você ativar essa configuração, ao clicar duas vezes ou pressionar a tecla Enter, o branch será verificado e seus commits serão exibidos.

Conteúdo relacionado

• Vídeo "Introdução ao Git no Visual Studio" no YouTube
• Produtividade aprimorada com o Git na postagem no blog do Visual Studio
• Caixa de diálogo Opções