Fazer uma confirmação do Git no Visual Studio
A parte central de qualquer fluxo de trabalho 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 arquivos 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 sua última confirmação.
- Arquivos modificados: Esses arquivos têm alterações desde sua última confirmação, mas você ainda não os preparou para a próxima confirmação.
- Arquivos em estágio: Estes arquivos têm alterações que serão adicionadas ao próximo commit.
À medida que trabalha, o Visual Studio controla as alterações de arquivo em seu projeto na secção Alterações da janela Alterações do Git.
Organize alterações e confirme
Para preparar alterações quando estiver pronto, selecione o botão + (mais) em cada arquivo que deseja preparar ou clique com o botão direito do mouse em um arquivo e selecione Estágio. Você também pode preparar todos os seus arquivos modificados com um clique usando o botão Preparar tudo + (plus) na parte superior da seção Alterações.
Quando se prepara uma alteração, o Visual Studio cria uma seção Alterações preparadas. Somente as alterações na seção Alterações Encenadas são adicionadas à próxima confirmação, o que pode ser feito selecionando Confirmar Alterações Encenadas. O comando equivalente para esta ação é git commit -m "Your commit message".
As alterações também podem ser desfeitas clicando no botão – (menos). O comando equivalente para esta ação é git reset <file_path> para desconfigurar um único arquivo ou git reset <directory_path> para desconfigurar todos os arquivos em um diretório.
Você também pode optar por não preparar seus arquivos modificados ignorando a área de preparação. Nesse caso, o Visual Studio permite que você confirme suas alterações diretamente sem precisar prepará-las. Basta inserir sua mensagem de confirmação e, em seguida, selecionar Confirmar tudo. O comando equivalente para esta 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. Quando você clica duas vezes em qualquer arquivo na Alterações de e nas seções Alterações em etapas, você pode ver uma comparação linha a linha com a versão não modificada do arquivo. Consulte Comparar arquivos - visualização de comparação.
Novo no versão 17.6: Pode também referenciar um problema ou um pull request digitando # ou selecionando o botão # no canto inferior direito da caixa de texto da mensagem de commit. Para obter mais informações, consulte a postagem de blog Problemas de referência e solicitações pull.
Novo no versão 17.12: Ao renomear um arquivo, você verá uma barra de notificação na parte superior da janela Git Changes informando que um arquivo foi renomeado e solicitando que você prepare essa alteração. Esta notificação aparece antes de preparar ou confirmar qualquer ação. Você pode querer preparar e confirmar a alteração antes de fazer outras alterações, para garantir que o Git detete a alteração como uma renomeação, não como uma exclusão e adição de um novo arquivo.
Novo no versão 17.13: Com do GitHub Copilot instalado, você pode fazer com que o GitHub Copilot revise suas alterações de código antes de confirmá-las. Para usar esse recurso, certifique-se de que Ferramentas>Opções>Visualizar Recursos> Pull Request Comments esteja habilitado e também habilite Ferramentas>Opções>GitHub>Copilot>Source Control Integration>Enable Git preview features.
Na janela Git Changes, clique no botão Revisar alterações com o Copilot, que se parece com um ícone de comentário com um brilho.
Depois de alguns momentos, um link mostrando o número de comentários de revisão de código aparece na janela Git Changes na qual você pode clicar para visualizar e navegar pelos comentários. Se não for detetado nenhum problema, aparecerá a mensagem Copilot não comentou em nenhum ficheiro.
O feedback da revisão de código aparece como comentários, que mostram um breve resumo do problema potencial, e você pode decidir fazer uma alteração ou descartar 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 do código Copilot.
Reverter, redefinir ou alterar um commit
Ao clicares duas vezes num Commit, o Visual Studio abre os seus detalhes numa 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 tag na confirmação. Quando clicas num ficheiro alterado no commit, o Visual Studio abre a visualização lado a lado Comparação do commit e do seu predecessor.
Gere 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.
Observação
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 Copiloto do GitHub para Visual Studio 2022 versão 17.10 ou posterior.
Se estiver a usar o Visual Studio nas versões 17.9 ou anteriores, consulte Obtenha o GitHub Copilot para o Visual Studio 2022 nas versões 17.8 a 17.9.
Quando estiver pronto para fazer uma confirmação, use o ícone de caneta brilhante (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 é criado e adicionado a tudo o que já existia. Leia com atenção para ver se está correto. Você tem a opção de aceitar a inserção ou descartá-la. Se aceitar a inserção, pode editar o texto antes de o enviar. Quando estiver pronto, escolha o botão de confirmação em etapas ou uma das outras opções de confirmação disponíveis na lista suspensa abaixo da caixa de edição da mensagem de confirmação.
Com o Visual Studio 2022 versão 17.12 e posterior, você pode personalizar o formato de mensagem de confirmação globalmente fornecendo orientação adicional no prompt para o GitHub Copilot. Para adicionar instruções de prompt personalizadas, abra Ferramentas>Opções>GitHub Copilote, sob Instruções personalizadas para a mensagem de commit, insira suas adições ao texto do prompt. As alterações afetam todas as mensagens de confirmação. Com essa orientação imediata, as equipes podem padronizar os formatos de mensagens de confirmação.
O GitHub Copilot entende termos como "assunto" (a primeira linha da mensagem de confirmação), "corpo" (a seção que descreve as alterações com mais detalhes) e "rodapé" (a seção final). Alguns exemplos incluem "Usar todas as letras minúsculas", "Limitar o assunto a 50 caracteres", "Limitar o corpo a 2 frases", "Adicionar um rodapé com três tralhas" ou "Seguir o padrão Conventional Commits", que faz referência ao amplamente utilizado padrão de Conventional Commits .
Observação
Leia sobre como o GitHub Copilot protege a privacidade de seus dados em Declaração de Privacidade Empresarial do GitHub Copilot.