Criar uma solicitação de pull no Visual Studio
Se você estiver autenticado no GitHub ou no Azure DevOps e tiver enviado alterações por push para o repositório remoto, poderá criar uma solicitação de 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 detectar problemas em novos recursos e permitem que os colegas compartilhem sua experiência com diferentes regiões da base de código, melhorando a integridade da base de código em geral.
Nota
Para experimentar o recurso, verifique se ele está habilitado no Tools>Options>Preview Features>Pull Request
Para criar uma solicitação de pull, siga estas etapas:
Antes de criar uma solicitação de pull, você precisa criar uma nova ramificação para suas alterações. Este ramo mantém suas modificações separadas do ramo principal até que elas estejam prontas para serem mescladas.
Em seguida, você pode confirmar e enviar por push suas alterações como faria normalmente na janela Alterações do Git.
Selecione o link na faixa de notificação para Criar no Visual Studio ou Criar no navegador.
Como alternativa, você pode criar uma solicitação de pull de uma ramificação remota navegando até a janela Nova Solicitação de Pull pelo menu de nível superior Git>GitHub ou Azure DevOps>Nova Solicitação de Pull. Ou clique com o botão direito do mouse em uma ramificação na Janela do Repositório Git.
Ou clique com o botão direito em uma ramificação na Janela do Repositório Git para abrir o menu de contexto e selecione Nova Pull Request.
Selecione a ramificação na qual você deseja mesclar e dê à sua solicitação de pull um título descritivo e uma descrição. É possível usar a sintaxe markdown para formatar a descrição do pull request no Visual Studio. Experimente digitando os símbolos de markdown na caixa Descrição e visualize sua marcação selecionando o botão Visualizar.
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 de pull que descreve suas alterações. Pressione o ícone de caneta de brilho para solicitar que o GitHub Copilot gere uma descrição de PR. Para instalar o GitHub Copilot, consulte Instalar e gerenciar o GitHub Copilot no Visual Studio.
A prévia das diferenças permite que você veja todas as alterações nos arquivos que foram confirmadas como parte do seu pull request. Confira Comparar arquivos – exibição de comparação.
Dica
A opção de visualização de diferenças resumidas permite que você examine apenas as seções de código alteradas.
Você pode vincular itens de trabalho referenciando-os 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 a identidade ou email do Azure DevOps.
Depois de clicar Criar na solicitação de pull, outros desenvolvedores poderão examinar suas alterações e fornecer comentários. Ou, com o Visual Studio 17.12 e posterior, clique na lista suspensa e escolha Criar como rascunho.
Com o Visual Studio 17.12 e posterior, você pode habilitar o recurso Modelos de Pull Request (em Ferramentas>Opções>Ambiente>Versão Prévia do Recurso) para que o modelo de PR padrão no repositório seja usado ao criar um novo pull request para o GitHub e o Azure DevOps. Saiba mais sobre como adicionar um modelo de solicitação pull ao repositório na documentação do GitHub e na documentação do Azure DevOps .
Exibir ou adicionar comentários em pull requests 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 habilitar esse recurso, abra Ferramentas>Opções>Versão Prévia do Recurso e verifique se Comentários de Pull Request está selecionado.
Exibir comentários de pull request
Para visualizar os comentários de um pull request, acesse qualquer branch com um pull request ativo e selecione Mostrar comentários em arquivos na barra de Informações. Você também pode selecionar o número do PR na janela Alterações do Git ou no menu principal do Git com Git>GitHub ou Azure DevOps>Mostrar comentários em arquivos.
Adicionar comentários em pull requests
Com o Visual Studio 17.13 ou posterior, você pode examinar uma solicitação de pull ou adicionar comentários.
Para habilitar esse recurso, abra Ferramentas>Opções>Versão Prévia do Recurso e verifique se Comentários de Pull Request está selecionado. Depois que eles forem ativados, faça o check-out de qualquer branch com uma pull request ativa e clique em Mostrar comentários em arquivos na barra de ferramentas e navegue pelas alterações usando os botões da barra de ferramentas acima do arquivo de código.
Para adicionar um comentário, clique no ícone Adicionar comentário ao 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 será publicado até que você clique no botão Adicionar Comentário na janela de comentários.
Você pode continuar a conversa em um comentário existente usando a seçã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 status para resolvido com um clique ou alterar o status usando a lista suspensa acima do texto do comentário.
Você pode alternar seu status de curtida em um comentário clicando no ícone, ou nos três pontos, você pode copiar o texto do comentário ou um link para ele para a área de transferência, excluir o comentário, ou abrir o comentário no navegador no site do fornecedor (como github.com ou seu site de projeto do Azure DevOps).
A capacidade de adicionar comentários a uma solicitação de pull é limitada para alguns provedores Git. Por exemplo, com o GitHub como provedor, você só pode adicionar comentários em linhas dentro de três linhas de uma alteração, mas com o provedor do Azure DevOps, você pode adicionar comentários em qualquer linha de um arquivo envolvido na solicitação de pull. Em qualquer caso, você só pode adicionar comentários em arquivos incluídos na solicitação de pull.
Usar 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 |
|---|---|
| Vá para o arquivo anterior na solicitação de pull | Ctrl+Shift+Alt+F6 |
| Vá para o próximo arquivo na solicitação de pull | Ctrl+Alt+F6 |
| Vá para o comentário anterior | Ctrl+Shift+Alt+F8 |
| Vá para o próximo comentário | Ctrl+Alt+F8 |
| Ocultar comentários em arquivos | Ctrl+Shift+F1 |
Próximas etapas
Para continuar seu percurso, visite a página Fetch, pull e sync no Visual Studio.