Fazer uma confirmação do Git no Visual Studio
A parte principal de qualquer fluxo de trabalho do Git é modificar arquivos e confirmar as alterações nesses arquivos. Embora este artigo faça referência aos repositórios do GitHub, você pode trabalhar remotamente com o provedor Git de sua escolha, como o GitHub ou o Azure DevOps. Ou você pode trabalhar localmente sem nenhum provedor.
O Git rastreia as alterações de arquivo em seu repositório enquanto você trabalha e separa os arquivos em seu repositório em três categorias. Essas alterações são equivalentes ao que você veria ao inserir o comando git status na linha de comando:
- arquivos não modificados: esses arquivos não foram alterados desde seu último commit.
- Arquivos modificados: esses arquivos têm alterações desde a última confirmação, mas você ainda não os preparou para a próxima confirmação.
- Arquivos preparados: esses arquivos têm alterações que serão adicionadas à próxima confirmação.
À medida que você faz seu trabalho, o Visual Studio acompanha as alterações de arquivo no seu projeto na seção Alterações da janela Alterações do Git.
Preparar alterações e fazer um commit
Para preparar alterações quando estiver pronto, clique no botão + (mais) em cada arquivo que deseja preparar ou clique com o botão direito do mouse em um arquivo e selecione Preparar. Também é possível preparar todos os arquivos modificados com um clique usando o botão preparar tudo + (mais) na parte superior da seção Alterações.
Quando você prepara uma alteração, o Visual Studio cria uma seção Alterações preparadas. Somente as alterações na seção Alterações Preparadas são adicionadas à próxima confirmação, o que você pode fazer selecionando Confirmar Preparadas. O comando equivalente para essa ação é git commit -m "Your commit message".
As alterações também podem não preparadas clicando no botão – (menos). O comando equivalente para essa ação é git reset <file_path> para cancelar a execução de um único arquivo ou git reset <directory_path> para desescarar todos os arquivos em um diretório.
Você também pode optar por não preparar seus arquivos modificados ignorando a área de preparo. Nesse caso, o Visual Studio permite que você confirme suas alterações diretamente sem precisar configurá-las. Basta inserir sua mensagem de confirmação e, em seguida, selecione Confirmar Tudo. O comando equivalente para essa ação é git commit -a.
O Visual Studio também facilita a confirmação e a sincronização com um clique usando os atalhos Confirmar Tudo e Enviar e Confirmar Tudo e Sincronizar. Ao clicar duas vezes em qualquer arquivo nas seções Alterações e Alterações preparadas, veja uma comparação linha a linha com a versão não modificada do arquivo. Confira Comparar arquivos – exibição de comparação.
Novidade na versão 17.6: também é possível referenciar um problema ou uma solicitação de pull digitando # ou clicando no botão # no canto inferior direito da caixa de texto da mensagem de confirmação. Para saber mais, confira a postagem no blog Problemas de referência e solicitações de pull.
Novo na versão 17.12 : ao renomear um arquivo, você verá uma barra de notificação na parte superior da janela Alterações do Git informando que um arquivo foi renomeado e solicitando que você prepare essa alteração. Essa notificação é exibida antes de você definir ou confirmar qualquer coisa. Talvez você queira preparar e confirmar a alteração antes de fazer outras alterações, a fim de garantir que o Git detecte a alteração como uma renomeação, não uma exclusão e adição de um novo arquivo.
Novidade na versão 17.13: com o GitHub Copilot instalado, você pode fazer com que o GitHub Copilot examine as alterações de código antes de confirmá-las. Para usar esse recurso, certifique-se de que Tools>Options>Preview Features>Pull Request Comments está habilitado e também habilite Tools>Options>GitHub>Copilot>Source Control Integration>Habilitar funções de pré-visualização do Git.
Na janela Alterações do Git, clique no botão Examinar alterações com o Copilot, que se parece com um ícone de comentário com um brilho.
Após alguns instantes, um link mostrando o número de comentários de revisão de código aparece na janela Alterações do Git em que você pode clicar para exibir e navegar pelos comentários. Se nenhum problema for detectado, a mensagem O Copilot não comentou em nenhum arquivo aparece.
Os comentários de revisão de código aparecem como comentários, que mostram um breve resumo do possível problema, e você pode decidir fazer uma alteração ou ignorar a caixa de comentários usando o botão de seta para baixo no canto superior direito da caixa de comentários.
Para remover todos os comentários, use o X na janela Alterações do Git para fechar o link de revisão de código do Copilot.
Reverter, redefinir ou alterar um commit
Quando você clica duas vezes em um Commit, o Visual Studio abre seus detalhes em uma janela de ferramenta separada. A partir daqui, você pode reverter a confirmação, redefinir (desfazer) a confirmação, alterar a mensagem de confirmação ou criar uma marca na confirmação. Quando você clica em um arquivo alterado na confirmação, o Visual Studio abre a exibição Comparação lado a lado da confirmação e seu pai.
Gerar mensagens de confirmação com o GitHub Copilot Chat
Com o Visual Studio versão 17.9 e posterior e as extensões do GitHub Copilot, você pode usar a IA para gerar mensagens de confirmação detalhadas que descrevem suas alterações.
Nota
Para habilitar mensagens de confirmação geradas por IA, você precisa do GitHub Copilot e do GitHub Copilot Chat. Se você estiver usando o Visual Studio versão 17.10 ou posterior, consulte Obter o GitHub Copilot para Visual Studio 2022 versão 17.10 ou posterior.
Se você estiver usando o Visual Studio, versões 17.9 ou anteriores, consulte Obter o GitHub Copilot para Visual Studio 2022 versões 17.8 a 17.9.
Quando estiver pronto para fazer uma confirmação, use o ícone de caneta sparkly (dica de ferramenta: Adicionar mensagem de confirmação gerada por IA) no canto inferior direito da caixa de texto da mensagem de confirmação para solicitar uma mensagem de confirmação gerada por IA. O texto gerado por IA é adicionado ao que você já possuía. Leia-o cuidadosamente para ver se ele é preciso. Você tem a opção de aceitar a inserção ou descartá-la. Se você aceitar a inserção, poderá editar o texto antes de enviá-lo. Quando tudo estiver pronto, selecione o botão Confirmar Etapas ou uma das outras opções de commit disponíveis na lista suspensa embaixo da caixa de edição da mensagem de commit.
Com o Visual Studio 2022 versão 17.12 e posterior, você pode personalizar o formato de mensagem de confirmação globalmente fornecendo orientações adicionais no prompt para o GitHub Copilot. Para adicionar instruções de prompt personalizado, abra Ferramentas>Opções>GitHub Copilot e, em Instruções personalizadas para mensagens de confirmação, insira suas adições ao texto do prompt. As alterações afetam cada mensagem de confirmação. Com essas diretrizes de prompt em vigor, as equipes podem padronizar formatos de mensagens de commit.
O GitHub Copilot entende termos como "assunto" (a primeira linha da mensagem de confirmação), "descrição" (a seção que descreve as alterações com mais detalhes) e "subtítulo" (a seção final). Alguns exemplos incluem "Usar todas as letras minúsculas", "Limitar o assunto a 50 caracteres", "Limitar o corpo a duas frases", "Adicionar um rodapé com três marcas de hash" ou "Seguir o padrão 'Conventional Commits'", que faz referência ao amplamente usado padrão 'Conventional Commits'.