Como trabalhar com Git no Visual Studio e Visual Studio Code: um guia completo e atualizado

Se você é um desenvolvedor ou está simplesmente interessado em trabalhar de forma eficiente com seus projetos de código, certamente já ouviu falar sobre Git e sua integração nos editores mais populares, como Visual Studio y Visual Studio Code. O controle de versão deixou de ser uma opção para se tornar uma necessidade real para qualquer equipe de desenvolvimento, mas você realmente sabe até onde pode ir gerenciando seus repositórios, branches e colaborações de dentro do próprio editor? Neste artigo contamos a você, do zero e em detalhes, como aproveitar ao máximo o Git dentro da família Visual Studio, seja você um desenvolvedor Windows como em outros sistemas, trabalhando sozinho ou em equipe.

Vamos nos aprofundar em como criar, clonar e gerenciar repositórios, como integrar os principais provedores de repositórios externos (GitHub, Azure DevOps, GitLab), como resolver conflitos, personalizar as opções do Git no IDE e um bom punhado de Truques para que seu fluxo de trabalho seja ágil, seguro e adaptado a você. Não importa se você é novo nesses ambientes ou já está aqui há anos, aqui está um guia abrangente e atualizado, repleto de conselhos práticos, passo a passo, em linguagem simples.

Por que usar o Git integrado ao Visual Studio e ao Visual Studio Code?

O sistema de controle de versão Git é, hoje, o padrão de fato para manter uma história segura, coordenada e eficiente de qualquer projeto de desenvolvimento, seja individual ou colaborativo. O melhor de tudo é que Visual Studio (tanto em suas edições quanto no Visual Studio Code, seu “irmãozinho” e mais leve) tem uma integração Git nativa muito poderosa, o que lhe permite esquecer completamente a linha de comandos se você preferir.

Ao trabalhar com o Git nesses ambientes, você pode:

• Criar novos repositórios, tanto locais quanto remotos, com apenas alguns cliques.
• Clonar projetos existentes do GitHub, GitLab, Azure DevOps ou qualquer outro provedor compatível.
• Gerenciar ramificações, confirmar e sincronizar alterações sem sair do editor.
• Resolva conflitos visualmente e simples, sem se perder entre comandos estranhos.
• Configure e personalize sua experiência ao máximo com Git de acordo com suas necessidades.

Visual Studio Destaca-se por possuir uma das interfaces mais completas e visuais para lidar com Git, especialmente otimizado para trabalhar com repositórios no GitHub e Azure DevOps. Por seu lado, Visual Studio Code É ideal se você procura algo leve e multiplataforma, com dezenas de extensões que expandem as possibilidades nativas.

Introdução: Pré-requisitos e instalação

Antes de começar a trabalhar com o Git, certifique-se de ter:

• Git instalado no seu sistema. Você pode baixar a versão para seu sistema operacional em git-scm. com. O Visual Studio geralmente detecta automaticamente, mas em alguns casos você precisará especificar o caminho manualmente.
• Visual Studio ou Visual Studio Code instalado. A integração com o Git está incluída nas versões mais recentes de ambos os editores.
• (opcional) Uma conta no GitHub, GitLab ou Azure DevOps se você for trabalhar com repositórios remotos. Não é essencial para um repositório local, mas é altamente recomendado se você quiser aproveitar a sincronização e a colaboração.

Depois que tudo estiver instalado, você pode começar a usar o Git em seus projetos a partir do próprio editor. Detalhamos as etapas nas seções a seguir.

Criação e clonagem de repositórios no Visual Studio

O Visual Studio torna muito mais fácil para você criar um novo repositório do zero ou clonar um existente. A primeira coisa é decidir se você vai trabalhar localmente (na sua equipe) ou propriedade (repositórios em nuvem, seja GitHub, GitLab ou Azure DevOps).

Como criar um novo repositório no Visual Studio

1. Abra o Visual Studio e selecione Crie um novo projeto.
2. Vá para o cardápio Git e escolha Criar repositório Git.
3. Uma caixa de diálogo será aberta onde você pode escolher:
   • GitHub como um alvo remoto (o usual, especialmente no Visual Studio 2022 e posteriores).
   • DevOps do Azure se você trabalha em ambientes empresariais.
   • Apenas locais se você quiser manter o repositório exclusivamente na sua máquina.
4. Você pode definir o nome, a visibilidade (pública, privada ou interna) e selecionar um modelo. .gitignore para evitar o upload de arquivos indesejados.
5. Clique em Criar e enviar para criar o repositório e, se aplicável, enviar o projeto para a nuvem.

Nas versões modernas do Visual Studio, o processo é virtualmente idêntico para a criação de repositórios em GitHub ou Azure DevOps. O assistente irá guia passo a passo e permite que você faça login na sua conta, caso ainda não tenha feito.

Clonar um repositório externo no seu computador

Para trabalhar com um projeto que já existe no GitHub, GitLab ou algum outro provedor, você só precisa do URL do repositório:

1. Abra o Visual Studio e selecione Repositório clone no menu Git.
2. Cole a URL do projeto (você pode copiá-la para o prancheta do próprio site do repositório, onde aparece o botão Code o clone).
3. Escolha a pasta no seu computador onde você deseja salvar a cópia local.
4. O Visual Studio baixará todo o conteúdo e o abrirá diretamente, carregando a solução principal se detectá-la (.sln).

Você também pode abrir repositórios locais existentes ou alternar entre eles convenientemente no menu do Git.

Trabalhando com repositórios no Visual Studio Code

Se você preferir Visual Studio Code, o processo é muito semelhante, embora a interface seja um pouco mais minimalista.

Crie um novo repositório com o Visual Studio Code

Você pode iniciar um repositório diretamente do editor ou usando o terminal integrado:

1. Abra a pasta do projeto no VS Code.
2. Vá para a guia Fonte de controle (ícone de garfo) na barra lateral esquerda.
3. Clique em Iniciar repositório. Uma pasta será criada .git no seu projecto.
4. Você pode verificar se ele foi criado corretamente executando ls -la no terminal para ver o diretório oculto .git.

Clonando repositórios no Visual Studio Code

1. Selecione a opção Repositório clone (da barra lateral ou usando Ctrl + Shift + P e digitando “Git: Clone”).
2. Cole a URL do seu GitHub, GitLab, Azure DevOps ou qualquer outro repositório remoto.
3. Escolha o diretório local onde você deseja clonar o conteúdo.
4. O VS Code perguntará se você deseja abrir a pasta clonada diretamente.

Isso permite que você comece em segundos qualquer projeto público ou privado ao qual tenha acesso.

Gerenciando arquivos e alterações: o ciclo básico do Git

Ao trabalhar com o Git, o fluxo básico é adicionar, modificar ou excluir arquivos, registrar mudanças em um commit e finalmente empurrar essas alterações no repositório remoto, se houver um. Tanto o Visual Studio quanto o VS Code simplificam e visualizam esse ciclo, poupando você de ter que lembrar de comandos.

Categorias de arquivos no Git

• Arquivos não rastreados (U):Eles foram adicionados à pasta do repositório, mas o Git ainda não os controla. Eles geralmente aparecem com uma letra U ou destacado em algum lugar na interface.
• Novos arquivos (A): Adicionado à área de preparação, pronto para ser confirmado.
• Arquivos modificados (M):Eles já existem no repositório e foram alterados.

Nos painéis de controle do código-fonte, você pode selecionar quais arquivos adicionar ao próximo commit, visualizar diferenças (diffs) entre versões e desfazer alterações, se necessário.

Como fazer commit e push do Visual Studio

1. Faça as alterações desejadas nos arquivos.
2. Abra a janela de Mudanças no Git no menu lateral ou superior.
3. Selecione os arquivos que deseja adicionar ao commit usando o botão “+” ou clique com o botão direito.
4. Escreva uma mensagem descritiva para o commit.
5. Clique em Confirmar para economizar localmente.
6. Quando você tiver vários commits ou quiser sincronizar suas alterações com o repositório remoto, pressione Empurrar o Sincronizar.

No VS Code, o processo é muito semelhante ao da seção Fonte de controle. Você pode usar atalhos como Ctrl + Enter para confirmar rapidamente ou pressionar os ícones de “estágio”, confirmar e enviar.

Indicadores visuais no Visual Studio Code

O VS Code usa indicações visuais na margem do código para mostrar o status das linhas:

• Barras azuis: linhas modificadas desde o último commit.
• Barras verdes: linhas adicionadas.
• Triângulos ou marcas vermelhas: linhas excluídas.

Além disso, você pode clicar duas vezes em qualquer arquivo modificado para ver uma visualização diferente comparando a versão atual e a anterior.

Gerenciamento de filiais e fluxo de trabalho colaborativo

Uma das maiores vantagens do Git é sua poderoso sistema de ramificação, o que permite que você trabalhe em diferentes linhas de desenvolvimento sem interferir nas mudanças. Tanto o Visual Studio quanto o VS Code oferecem maneiras fáceis de criar, alternar e gerenciar ramificações.

Criar e alternar ramificações no Visual Studio

• Da janela de Mudanças no Git ou o Repositório Git Você pode ver sua ramificação atual e alternar entre as existentes.
• Para criar uma nova ramificação, basta digitar o nome, escolher em qual ramificação você deseja basear e selecionar a opção para alternar automaticamente. O comando equivalente seria git checkout -b nombre-rama.
• Você pode basear sua ramificação em qualquer outra ramificação (local ou remota) e gerenciar o histórico a partir da visualização da ramificação.

O Visual Studio exibe a ramificação ativa na parte superior da janela e na barra de status.

Gerenciamento de Branch no Visual Studio Code

No canto inferior esquerdo do editor, você verá o nome do branch no qual está trabalhando. Clicando lá você pode:

• Mude para outro ramo.
• Crie uma nova ramificação.
• Excluir, renomear ou mesclar ramificações locais.

Tudo isso é feito por meio de menus contextuais e de forma visual.

Sincronização, colaboração e solicitações de mesclagem

Trabalhar com repositórios remotos envolve manter sua cópia local sincronizada com a versão "oficial" e, muitas vezes, colaborar como uma equipe por meio solicitações de pull o solicitações de mesclagem, de acordo com o fornecedor.

Mudanças de push e pull

• Quando você faz um commit, as alterações são salvas somente no seu repositório local. É preciso empurrar para transferi-los para o controle remoto.
• Para atualizar seu repositório com alterações de outros pares, use puxar (baixe e aplique os novos commits) ou buscar (basta baixá-los sem aplicá-los).
• O Visual Studio e o VS Code contêm botões dedicados para essas ações, tornando a sincronização muito mais fácil.

Solicitações de mesclagem e solicitações de pull

• Em plataformas como GitLab ou GitHub, as principais mudanças são integradas ao branch principal usando um Solicitação de mesclagem o Solicitação de pull.
• Você pode criar um MR diretamente no site do fornecedor após enviá-lo, indicando os ramos de origem e destino, título, revisores e uma descrição das alterações.
• O Visual Studio e o VS Code permitem que você inicie e acompanhe o status dessas solicitações, embora algumas operações avançadas (como atribuir revisores ou mesclar) geralmente sejam melhor realizadas na interface da web.

Ferramentas de resolução de conflitos e comparação

Em qualquer fluxo de trabalho colaborativo, é comum encontrar conflitos de fusão. Elas ocorrem quando dois desenvolvedores modificam as mesmas linhas e o Git não consegue decidir qual escolher. Tanto o Visual Studio quanto o VS Code tornam extremamente simples detectar e resolver esses conflitos.

Como detectar e resolver conflitos no Visual Studio

• Quando ocorre um conflito, O Visual Studio indica claramente isso na janela Repositório Git e na seção de alterações.
• Ao abrir o arquivo conflitante, você verá tags como <<<<<<< HEAD ... ======= ... >>>>>>> rama, mas o Visual Studio exibe uma barra de informações dourada na parte superior que permite que você acesse o editor de fusão visual.
• Este editor é tridimensional: Você pode comparar as alterações atuais, as alterações recebidas e o resultado final da mesclagem, escolhendo facilmente quais alterações manter.
• Quando terminar, basta confirmar o resultado para completar a solução.

O Visual Studio Code, embora mais básico por padrão, também permite resolução visual de conflitos e pode expandir suas opções por meio de extensões.

Configuração e personalização avançadas do Git no Visual Studio

Se você deseja levar o controle de versão para o próximo nível, tanto o Visual Studio quanto o VS Code permitem que você ajustar parâmetros do Git para se adaptar ao seu fluxo de trabalho e necessidades específicas.

Opções de configuração mais importantes

• Nome e e-mail: Você pode defini-los globalmente ou por projeto no menu de configurações do Git, e eles serão os que aparecerão em cada commit.
• Gerenciando filiais remotas: É recomendável ter a opção de excluir ramificações remotas obsoletas habilitada ao buscar (fetch.prune (em Verdadeiro).
• Política de Mesclagem (Rebase/Combinar): Você pode escolher se as ramificações serão mescladas usando mesclagem tradicional ou rebase, tanto globalmente quanto por repositório.
• Provedor de rede criptográfica: Você pode escolher entre o OpenSSL e o Windows Secure Channel (SChannel) para gerenciar certificados e conexões seguras.
• Gerenciador de credenciais: Você pode escolher entre GCM para Windows, GCM Core ou deixar as configurações padrões.
• Ferramentas de comparação e mesclagem: Você pode usar o Visual Studio como comparador/mesclagem padrão ou definir um externo.
• .gitignore e gitattributes: Ambos os arquivos podem ser facilmente editados nas opções avançadas para controlar quais arquivos são carregados e como atributos específicos são manipulados.

O Visual Studio também oferece configurações específicas, como:

• Localização padrão dos repositórios clonados.
• Opções para fechar soluções abertas ao abrir outro repositório.
• Carregamento automático da solução se houver apenas um no repositório.
• Permitir extração automática de ramificação com duplo clique.
• Baixar imagens do autor do Gravatar (para ver fotos na história).
• Permitir push com –force-with-lease para substituir alterações com segurança.