Partilhar via


Preferências e configurações do Git no Visual Studio

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

Visual Studio 2019 | Visual Studio 2022

No Visual Studio, você pode exibir e configurar várias configurações e preferências relacionadas ao Git. Por exemplo, pode definir o seu nome e endereço de e-mail para metadados de commit, especificar as suas ferramentas de diffs e fusão preferidas e definir o caminho da pasta padrão para clones de repositório.

As configurações e preferências do Git no Visual Studio se enquadram em duas categorias principais:

  • Configurações Globais do Git, que se aplicam a todos os repositórios Git para o usuário atual.

  • Configurações do repositório Git, que se aplicam ao repositório Git ativo.

Dentro dessas categorias, as configurações podem ser:

  • definições do arquivo de configuração do Git, que você pode exibir e modificar no Visual Studio, na linha de comando ou editando um arquivo de configuração do Git. Exemplos de definições de arquivo de configuração do Git são nome de usuário, endereço de e-mail e aliases remotos. O Git armazena configurações em arquivos de configuração do Git do sistema, globais e locais:

    • As definições do arquivo de configuração do System Git aplicam-se a todos os usuários e repositórios no seu computador.

    • As definições do arquivo de configuração global do Git aplicam-se a todos os repositórios para o usuário atual. As configurações globais têm precedência sobre as configurações do sistema.

    • As definições do arquivo de configuração local do Git aplicam-se ao repositório local que contém o arquivo de configuração do Git local. As configurações do sistema têm precedência sobre as configurações globais.

  • configurações relacionadas ao Git do Visual Studio, que são configurações do Visual Studio relacionadas ao Git, mas não são armazenadas em nenhum arquivo de configuração do Git. Você só pode exibir e modificar essas configurações no Visual Studio. Um exemplo de uma dessas configurações é o caminho da pasta padrão onde o Visual Studio clona repositórios.

Neste artigo, vai aprender a:

  • Explore as configurações do Git
  • Modificar definições do arquivo de configuração do Git
  • Modificar configurações relacionadas ao Git do Visual Studio

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 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 permissão Criar repositório a nível de projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do repositório Git.
Serviços Repos ativado.
Ferramentas Opcional. Use 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.

Categoria Requerimentos
Acesso ao projeto Membro de um projeto .
Permissões - Visualização de código: Pelo menos acesso básico.
- Clone ou contribua para o código: Membro do grupo de segurança Contributors ou com permissões correspondentes no projeto.
Serviços Repos ativado.

Explore as configurações do Git

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. Para definir as configurações do Git no Visual Studio, escolha Configurações do Git > na barra de menus para abrir a exibição Opções .

    Captura de tela da opção Configurações na barra de menus do Visual Studio.

  2. Na visualização Opções, escolha Configurações Globais do Git para ver as configurações que se aplicam a todos os seus repositórios.

    Captura de tela das Configurações Globais do Git na caixa de diálogo Opções do Visual Studio.

    Ou, na visualização Opções , escolha Configurações do repositório Git > Geral para exibir as configurações que se aplicam apenas ao repositório de projeto atual do Visual Studio.

    Captura de tela das Configurações do repositório Git na caixa de diálogo Opções do Visual Studio.

Modificar definições do arquivo de configuração do Git

Você pode exibir e editar as definições de configuração do Git no Visual Studio ou editando diretamente o arquivo de configuração do Git aplicável. Para obter mais informações sobre as definições do arquivo de configuração do Git, consulte Personalizando o Git e documentação do git-config. Nas seções a seguir, discutimos como você pode editar cada uma das definições do arquivo de configuração do Git listadas:

Nome e e-mail

Quando se confirmar alterações, o Git guarda o seu nome e endereço de e-mail nos metadados da confirmação. Você pode editar o nome e o endereço de e-mail que o Git usará.

As configurações de nome e email estão disponíveis no escopo global ou de repositório.

No menu Git, escolha Configurações do > Git e selecione a visualização Configurações Globais do Git. Essa exibição contém as configurações de nome e e-mail para o usuário atual.

Captura de tela das configurações de nome e e-mail nas Configurações Globais do Git na caixa de diálogo Opções do Visual Studio.

Ou, escolha Configurações do repositório Git > Geral para editar as configurações de nome e email para o repositório de projeto atual do Visual Studio.

Puxe ramificações remotas durante a busca

Você pode configurar o Git para podar ramificações remotas durante cada fetch, removendo ramificações obsoletas de rastreamento remoto no seu repositório local que já não existem no repositório remoto correspondente.

No menu Git, escolha Configurações do > Git e selecione a visualização Configurações Globais do Git. Essa exibição contém as ramificações remotas Prune durante a opção de de busca para o usuário atual.

Captura de tela das ramificações remotas Prune durante a configuração de busca em Configurações Globais do Git na caixa de diálogo Opções do Visual Studio.

Ou, escolha Configurações do repositório Git > Geral para editar a configuração Excluir ramificações remotas durante a busca para o repositório de projeto atual do Visual Studio.

Os valores válidos são:

  • True (recomendado)
  • False
  • Unset (padrão)

Rebase a ramificação local ao fazer pull

Você pode optar por rebase sua filial local ao puxar para reproduzir as alterações na sua ramificação local sobre o histórico da filial remota.

A ramificação local Rebase ao puxar configuração corresponde ao comando git config pull.rebase. Você pode especificar essa configuração no escopo global ou de repositório.

No menu Git, escolha Configurações do > Git e selecione a visualização Configurações Globais do Git. Essa vista contém a branch local Rebase quando utiliza a opção para o utilizador atual.

Captura de tela da configuração de rebase em Configurações Globais do Git na caixa de diálogo Opções do Visual Studio.

Ou escolha Configurações do repositório Git > Geral para editar a ramificação local do Rebase ao puxar opção para o repositório de projeto atual do Visual Studio.

Os valores válidos são:

  • True: Faça rebase da ramificação atual sobre a ramificação remota após o fetch.
  • False: Mescle a ramificação remota na ramificação atual.
  • Merges: Rebaser sem achatar as confirmações de mesclagem criadas localmente.
  • Unset (padrão): a menos que especificado de outra forma em um arquivo de configuração do Git, mescle a ramificação remota na ramificação atual.

Provedor de rede criptográfica

Você pode especificar o provedor de rede criptográfica como o back-end TLS/SSL que o Git usará em tempo de execução.

A configuração do fornecedor de rede criptográfica corresponde ao comando git config http.sslBackend. Essa configuração só está disponível no escopo global.

No menu Git, escolha Git Configurações > e, em seguida, selecione a visualização Configurações Globais do Git. Essa exibição contém a opção do provedor de rede criptográfica para o usuário atual.

Captura de tela da configuração do provedor de rede criptográfica com OpenSSL selecionado no Visual Studio.

Os valores válidos são:

  • OpenSSL: use OpenSSL para protocolos TLS e SSL.
  • Secure Channel: use o Canal Seguro para protocolos TLS e SSL. O Secure Channel é a solução nativa do Windows que contém um conjunto de protocolos de segurança que fornecem autenticação de identidade e comunicação segura e privada por meio de criptografia.
  • Unset (padrão): se essa configuração estiver desdefinida, o provedor de rede criptográfica assumirá como padrão OpenSSL.

Auxiliar de credenciais

Quando o Visual Studio executa uma operação Git remota, o ponto de extremidade remoto pode rejeitar a solicitação porque requer credenciais para a solicitação. Quando isso acontece, o Git invoca um auxiliar de credenciais para obter as credenciais necessárias e, em seguida, tenta novamente a solicitação. Você pode especificar o auxiliar de credenciais que o Git usará.

A configuração auxiliar de credenciais corresponde ao comando git config credential.helper. Essa configuração só está disponível no escopo global.

  1. No menu Git, escolha Configurações do Git> e selecione a vista Configurações Globais do Git para definir essa configuração.

  2. Defina auxiliar de credenciais com o valor desejado e selecione OK para salvar.

    Captura de tela da configuração auxiliar de credenciais na caixa de diálogo Opções no Visual Studio.

Os valores válidos são:

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

Ferramentas de comparação e mesclagem

Você pode especificar quais ferramentas o Git usará para exibir diffs ou conflitos de mesclagem.

As configurações da ferramenta de comparação e mesclagem correspondem aos comandos git config diff.tool e git config merge.tool. Você pode definir o Visual Studio como a ferramenta de mesclagem ou de comparação, ou configurar outras ferramentas de mesclagem e comparação a partir da linha de comando Git . Você pode especificar as configurações da ferramenta de diff e de mesclagem no âmbito global ou do repositório.

  1. No menu Git, escolha Configurações > Git e, em seguida, selecione a visualização Configurações Globais do Git. Essa visualização contém as configurações das ferramentas de comparação e mesclagem.

  2. Defina as configurações da ferramenta de comparação e mesclagem para o valor desejado e selecione OK para salvar.

    Captura de tela mostrando as configurações da ferramenta de comparação e mesclagem na caixa de diálogo Opções no Visual Studio.

    Ou, escolha Configurações do repositório Git > Geral para editar as configurações da ferramenta de diff e mesclagem para o repositório atual do projeto Visual Studio.

As ferramentas de comparação e mesclagem válidas são:

  • Visual Studio
  • None (padrão)

Para definir outras configurações da ferramenta de comparação e mesclagem, use a linha de comando Git.

Controles remotos

Você pode usar o painel Remotes em Configurações do repositório Git para adicionar, editar ou remover controles remotos do repositório. Essa configuração corresponde ao comando git remote add. O painel de Remotes só está disponível no escopo do repositório.

Quando você clona um repositório remoto, o Git atribui o alias origin como abreviação para a URL do repositório remoto clonado. Por conveniência, você pode adicionar outro alias chamado upstream para o repositório do qual você se bifurcou, que é conhecido como o repositório upstream. As etapas a seguir descrevem como adicionar um upstream alias.

Para adicionar um upstream alias no Visual Studio, siga estes passos:

  1. Escolha Ferramentas > Opções na barra de menus para abrir a janela Opções. Selecione Source Control > Configurações do Repositório Git > Remotos e escolha Adicionar para abrir a Caixa de Diálogo Adicionar Remoto.

    Captura de tela do botão Adicionar no painel Remotes do submenu Configurações do repositório Git do menu Controle do código-fonte no Visual Studio.

  2. Na caixa de diálogo Adicionar remoto, adicione um novo controle remoto chamado upstream e insira a URL de clone do Git do repositório bifurcado. Em seguida, escolha Salvar.

    Captura de ecrã da caixa de diálogo Adicionar Remoto no Visual Studio.

Outras configurações

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


As configurações a seguir gerenciam preferências relacionadas ao Git no Visual Studio. Você só pode exibir e editar essas configurações de dentro do Visual Studio.

Para obter mais informações sobre como acessar as configurações relacionadas ao Git do Visual Studio, consulte Explore as configurações do Git. Em seguida, discutimos como você pode editar cada uma dessas configurações relacionadas ao Visual Studio Git.

Local padrão do repositório

Você pode definir a pasta de repositório padrão na qual o Visual Studio clonará repositórios.

A configuração local do repositório padrão só está disponível no escopo global.

  1. No menu Git, escolha Configurações do Git > e, em seguida, selecione a visualização Configurações Globais do Git. Essa exibição contém a configuração de local do repositório padrão.

  2. Defina o local padrão do repositório e selecione OK para salvar.

    Captura de tela mostrando o campo de local padrão no Visual Studio.

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

Por padrão, o Visual Studio fecha qualquer solução ou pasta aberta em um repositório Git quando você alterna para um repositório diferente. A configuração Fechar soluções abertas que não estão no Git ao abrir um repositório mantém a solução ou pasta aberta consistente com o repositório selecionado. No entanto, se sua solução ou pasta não estiver dentro de um repositório, convém manter a solução aberta quando alternar o repositório. Você pode fazer isso com essa configuração.

Tip

Se você emparelhar essa configuração com Carregar automaticamente a solução ao abrir um repositório Git, o Visual Studio abrirá a solução para o repositório Git para o qual você está alternando.

A configuração Fechar soluções abertas que não estão sob Git ao abrir um repositório está disponível apenas no escopo global.

  1. No menu Git, escolha Configurações do Git > e selecione a visualização Configurações Globais do Git para definir essa configuração.

  2. Defina o local padrão do repositório e selecione OK para salvar.

    Captura de ecrã mostrando a configuração nas Opções do Visual Studio para fechar soluções abertas que não estão no Git ao abrir um repositório.

Os valores válidos são:

  • Yes: quando você alterna o repositório, o Visual Studio fecha qualquer solução aberta.
  • No: quando você alterna o repositório e a solução ou pasta atual não está no Git, o Visual Studio manterá a solução ou pasta aberta.
  • Always ask (padrão): quando você alterna o repositório e a solução ou pasta atual não está no Git, o Visual Studio perguntará se você deseja manter a solução atual aberta.

Ativar o download de imagens de autor de fontes de terceiros

Quando ativado, o Visual Studio baixará uma imagem de autor do serviço de imagens Gravatar para exibição nas vistas de confirmação e histórico. Se você não configurou uma imagem Gravatar, o serviço de imagem Gravatar retornará uma imagem gerada aleatoriamente para você.

Importante

Para fornecer imagens de autor nas exibições de confirmação e histórico, o Visual Studio cria um hash MD5 usando o endereço de e-mail do autor armazenado no repositório ativo e envia esse hash para Gravatar. Se Gravatar encontrar um usuário com um hash correspondente, o Visual Studio recuperará e exibirá a imagem do usuário. A Microsoft não grava nem partilha endereços de correio eletrónico com Gravatar ou qualquer outro terceiro.

A configuração Habilitar download de imagens de autor de fontes de terceiros só está disponível no escopo global.

  1. No menu Git, escolha Configurações do > Git e selecione a visualização Configurações Globais do Git. Essa exibição contém a configuração Habilitar download de imagens de autores de fontes de terceiros.

  2. Escolha se deseja habilitar o download de imagens de autor de fontes de terceiros e selecione OK para salvar.

    Captura de tela mostrando a caixa de seleção para habilitar o download de imagens de autor de fonte de terceiros na caixa de diálogo Opções no Visual Studio.

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

Com Confirmar alterações após a mesclagem por padrão habilitada, o Git cria automaticamente uma nova confirmação na mesclagem de ramificação.

  • Quando marcada, todos os comandos git merge emitidos pelo Visual Studio são executados com a opção --commit.
  • Quando desmarcada, todos 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 de mesclagem, consulte --commit e --no-commit e --no-ff.

A configuração Confirmar alterações após a mesclagem por padrão só está disponível no escopo global.

  1. No menu Git, escolha Configurações do Git > e depois selecione a visualização Configurações Globais do Git. Essa exibição contém a configuração Confirmar alterações após a mesclagem por padrão.

  2. Escolha se deseja confirmar as alterações após a mesclagem por padrão e selecione OK para salvar.

    Captura de tela mostrando a caixa de seleção para confirmar alterações após a mesclagem por padrão na caixa de diálogo Opções no Visual Studio.

Ativar push --force-with-lease

Com esta configuração ativada, pode fazer push de alterações que sobrescrevem o trabalho numa ramificação remota, se mais ninguém fez push para a ramificação remota desde o seu último pull.

A opção Ativar push --force-with-lease corresponde ao comando push --force-with-lease. Essa configuração só está disponível no escopo global. Por padrão, Enable push --force-with-lease está desativado.

  1. No menu Git, escolha Configurações de > Git e, em seguida, selecione a visualização Configurações Globais do Git. Essa vista contém a configuração Enable push --force-with-lease.

  2. Escolha se deseja ativar push --force-with-leasee selecione OK para salvar.

    Captura de tela mostrando a caixa de seleção para ativar a força de push com concessão na caixa de diálogo Opções no Visual Studio.

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

Quando habilitado e você abre um repositório Git no Visual Studio, o Visual Studio verificará a pasta do repositório em busca de soluções, CMakeLists.txtou outros arquivos de exibição e os exibirá como uma lista no Gerenciador de Soluções. Em seguida, você pode carregar uma solução ou exibir o conteúdo de uma pasta. Esta definição está ativada por predefinição.

Quando desabilitado e você abre um repositório Git no Visual Studio, o Visual Studio não abrirá a pasta repo no Gerenciador de Soluções e será apenas um gerenciador de repositórios Git.

  1. No menu Git, escolha Configurações do Git > e selecione a visualização Configurações Globais do Git para definir essa configuração.

  2. Escolha se deseja habilitar pasta Abrir no Gerenciador de Soluções ao abrir um repositório Gite selecione OK para salvar.

    Captura de tela mostrando a caixa de seleção para abrir a pasta ao abrir um repositório Git na caixa de diálogo Opções.

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

A configuração Carregar automaticamente a solução ao abrir um repositório Git é aplicável somente se a configuração Abrir pasta no Gerenciador de Soluções ao abrir um repositório Git também estiver habilitada. Quando você abre um repositório Git no Visual Studio, e a verificação de pasta subsequente deteta que há apenas uma solução presente em seu repositório, o Visual Studio carrega automaticamente essa solução. Se você desativar essa configuração, o Gerenciador de Soluções exibirá a única solução presente no repositório na lista de exibições, mas não carregará a solução. Esta definição está desativada por predefinição

  1. No menu Git, escolha Configurações do Git > e selecione a visualização Configurações Globais do Git para definir essa configuração.

  2. Escolha se deseja ativar Carregar automaticamente a solução ao abrir um repositório Gite selecione OK para salvar.

    Captura de tela mostrando a caixa de seleção para carregar automaticamente a solução ao abrir um repositório Git na caixa de diálogo Opções.

Faça check-out automático de ramificações com um clique duplo ou com a tecla Enter

A janela Repositório Git tem uma lista de ramificações exibidas em uma estrutura de árvore. Selecione uma ramificação para alternar o painel de histórico de confirmações para exibir as confirmações dessa ramificação. Para fazer check-out de uma filial, clique com o botão direito do mouse para abrir o menu de contexto e escolha Checkout. Com a configuração Fazer check-out automático de ramificações ao clicar duas vezes ou pressionar a tecla Enter ativada, pode-se clicar duas vezes ou selecionar a tecla Enter para fazer check-out de uma ramificação e exibir os seus commits.

  1. No menu Git, escolha Configurações do Git > e selecione a visualização Configurações Globais do Git para definir essa configuração.

  2. Escolha se deseja ativar Extrair automaticamente ramificações com um duplo clique ou a tecla Entere selecione OK para guardar.

    Captura de tela mostrando a caixa de seleção para verificar ramos com clique duplo ou tecla Enter na caixa de diálogo Opções.

Editar o arquivo .gitignore e o arquivo de atributos do Git

O Visual Studio fornece uma maneira rápida de adicionar ou editar gitignore e arquivos gitattributes na raiz do seu repositório.

A opção de adicionar ou editar um arquivo gitignore ou gitattributes só está disponível no escopo do repositório.

  1. No menu Git, escolha Configurações do Git > e escolha a visualização Configurações do repositório Git > Geral. Essa vista contém opções para editar ficheiros gitignore ou gitattributes.

  2. Escolha Editar para abrir o ficheiro ignorar ou atributo numa janela do editor do Visual Studio.

    Captura de tela mostrando o botão Editar para os arquivos ignorar ou atributo no Visual Studio.

Para obter informações sobre como configurar arquivos .gitignore e .gitattributes, consulte gitignore e gitattributes.

Próximos passos