Compartilhar via


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:

  1. 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.

  2. Em seguida, você pode confirmar e enviar por push suas alterações como faria normalmente na janela Alterações do Git.

  3. Selecione o link na faixa de notificação para Criar no Visual Studio ou Criar no navegador.

    Captura de tela da janela Alterações do Git com a barra de informações

    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.

    o menu de nível superior do Git com o GitHub selecionado e o texto

    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.

    a janela do repositório Git com o texto do link de entrada/saída realçado no Visual Studio 2022.

  4. 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.

    Captura de tela do ícone de caneta cintilante para solicitar que o GitHub Copilot gere uma descrição de PR.

    A janela Novo Pull Request com o texto do botão de pré-visualização destacado no Visual Studio 2022.

  5. 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.

    A janela Novo Pull Request com o texto do botão de resumo destacado no Visual Studio 2022.

  6. 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.

    O Novo Pull Request com # na caixa de descrição e uma lista dos problemas relacionados do GitHub e os pull requests mostrados no Visual Studio 2022.

  7. 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.

    Captura de tela mostrando a opção de criar um novo pull request como um 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.

Captura de tela mostrando comentários de PR.

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.

Captura de tela mostrando o link para exibir comentários na janela Alterações do Git.

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.

Captura de tela mostrando o ícone Adicionar comentário ao revisar uma alteração de arquivo em uma solicitação de pull.

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.

Consulte também