Criar uma solicitação pull no Visual Studio

Se você estiver autenticado no GitHub ou no Azure DevOps e tiver enviado alterações por push para seu repositório remoto, poderá criar uma solicitação pull sem sair do Visual Studio. As solicitações pull são uma ferramenta essencial no GitHub e no Azure DevOps para revisão de código. Essas revisões ajudam a detetar problemas em novos recursos e permitem que os colegas de equipe compartilhem suas experiências com diferentes regiões da base de código, melhorando a integridade da base de código em geral.

Para criar uma solicitação pull, siga estas etapas:

1. Antes de criar um pedido pull, precisas criar uma ramificação nova para as tuas alterações. Essa ramificação mantém suas modificações separadas da ramificação principal até que estejam prontas para serem mescladas.

2. Em seguida, podes confirmar e enviar as tuas alterações como farias normalmente na janela Alterações do Git.

3. Selecione o link no banner de notificação para criar no Visual Studio ou criar no navegador.

   

   Como alternativa, você pode criar uma solicitação pull de uma ramificação remota navegando até a janela New Pull Request por meio do menu de nível superior Git>GitHub ou Azure DevOps>New Pull Request. Ou clique com o botão direito do mouse em uma ramificação na janela Repositório Git.

   

   Ou selecione com o botão direito do mouse uma ramificação na janela do repositório Git para abrir o menu de contexto e selecione Nova solicitação pull.

   

   Quando tentas criar um pull request mas tens várias contas no teu porta-chaves, vês um prompt a perguntar qual conta usar. Consulte Adicionar contas do GitHub às suas chaves.

4. Selecione a ramificação na qual pretende mesclar e dê ao seu pedido de pull um título e uma descrição descritivos. Você pode usar sintaxe de marcação para formatar sua descrição de solicitação pull do Visual Studio. Experimente escrevendo os símbolos de markdown na caixa Descrição e visualize seu markdown selecionando o botão Preview.

   Dica

   Com o Visual Studio 2022 versão 17.10 e posterior e as extensões do GitHub Copilot, você pode usar a IA para gerar uma descrição detalhada da solicitação pull que descreve suas alterações. Pressione o ícone da caneta de brilho para solicitar que o GitHub Copilot gere uma descrição de RP. Para instalar o GitHub Copilot, consulte Instalar e gerenciar o GitHub Copilot no Visual Studio.

   

   

5. A pré-visualização das diferenças permite ver todas as alterações nos ficheiros que foram submetidas como parte do seu pedido de pull. Consulte Comparar arquivos - visualização de comparação.

   Dica

   A opção de exibição de diferença de resumo permite que você revise apenas as seções alteradas do código.

   

6. Você pode vincular itens de trabalho fazendo referência a eles com a pesquisa de problemas , digitando # na caixa de descrição ou pressionando o botão # no canto inferior direito. Você também pode adicionar seus revisores digitando seu nome de usuário do GitHub ou identidade ou email do Azure DevOps.

   

7. Depois de clicar em Criar no seu pull request, outros desenvolvedores podem revisar as suas alterações e fornecer feedback. Ou, com o Visual Studio 17.12 ou posterior, clique no menu suspenso e escolha Criar como rascunho.

   

Saiba mais sobre como adicionar um modelo de solicitação pull ao seu repositório na Documentação do GitHub e na Documentação do Azure DevOps .

Ver ou adicionar comentários de pull request no editor

Com o Visual Studio 17.11 ou posterior, você pode exibir comentários e sugestões de revisores sem alternar contextos para o navegador.

Para ativar esta funcionalidade, abra o painel Ferramentas>Opções, expanda a secção Todas as Definições>Funcionalidades de Pré-visualização e selecione ao lado de Comentários de Pull Request.

Ver comentários de pull request

Para exibir os comentários de uma solicitação pull, verifique qualquer ramificação com uma ramificação de pull request ativa e selecione Mostrar comentários em arquivos na barra de informações. Você também pode selecionar o número PR na janela Git Changes ou no menu de nível superior do Git com Git>GitHub ou Azure DevOps>Mostrar comentários em arquivos.

Adicionar comentários em pull request

Com o Visual Studio 17.13 ou posterior, você pode revisar uma solicitação pull ou adicionar comentários. Para ativar esta funcionalidade, abra o painel Ferramentas>Opções, expanda a secção Definições Gerais>Funcionalidades de Pré-visualização e selecione a caixa de verificação Comentários de Pull Request.

Depois de ativares os comentários, verifica qualquer ramo com um pull request ativo e clica em Mostrar comentários nos ficheiros na barra de informação. Navegue pelas alterações usando os botões da barra de ferramentas acima do ficheiro de código.

Para adicionar um comentário, clique no ícone Adicionar comentário no lado esquerdo do editor, conforme mostrado na captura de tela a seguir.

Você também pode clicar com o botão direito do mouse em uma linha de código e, no menu de contexto, escolher Git>Adicionar comentário.

O texto do comentário não é publicado até clicares no botão Adicionar Comentário na janela de comentários.

Você pode continuar a conversa em um comentário existente usando a secção Responder na caixa de comentários. Os comentários estão ativos ou resolvidos. Você pode clicar em Responder e Resolver para responder a um comentário e alterar o estado para resolvido com um clique, ou alterar o estado usando o menu pendente acima do texto do comentário.

Você pode alternar seu status de curtida em um comentário clicando no ícone ou clicando nos três pontos, pode copiar o texto do comentário para a área de transferência, copiar um link para o comentário para a área de transferência, excluir o comentário ou abrir o comentário no navegador da Web no site do provedor (como github.com ou seu site de projeto do Azure DevOps).

A capacidade de adicionar comentários a uma solicitação pull é limitada para alguns provedores Git. Por exemplo, com o GitHub como provedor, você só pode adicionar comentários em linhas dentro de 3 linhas de uma alteração, mas com o provedor de DevOps do Azure, você pode adicionar comentários em qualquer linha de um arquivo envolvido na solicitação pull. Em qualquer caso, você só pode adicionar comentários em arquivos que estão incluídos na solicitação pull.

Ver comentários na visão de diferenças

Você pode exibir comentários na visualização de diferenças e também na visualização de arquivo. Na visualização de comparação, você pode ver comentários ao lado do código original e atualizado. Isso torna mais fácil ver exatamente o que foi alterado e por quê. Também pode editar o ficheiro de trabalho diretamente nesta vista.

Formatação Markdown nos comentários

Na visualização de arquivo ou na visualização de comparação, os comentários são renderizados usando a formatação Markdown.

Utilizar o teclado

Você pode navegar entre arquivos e comentários individuais usando os ícones na barra de ferramentas ou usar os seguintes atalhos de teclado:

Ação	Atalho de teclado
Ir para o arquivo anterior na solicitação pull	Ctrl+Shift+Alt+F6
Ir para o próximo arquivo na solicitação pull	+ Ctrl+ AltF6
Ir para o comentário anterior	Ctrl+Shift+Alt+F8
Ir para o próximo comentário	+ Ctrl+ AltF8
Ocultar comentários em ficheiros	Ctrl+Shift+F1

Próximos passos

Para continuar sua jornada, visite a página Buscar, extrair e sincronizar no Visual Studio.

Ver também

• experiência Git no Visual Studio
• Visual Studio & GitHub: Melhor juntos