Revisar alterações proposta em pull requests

Em uma solicitação de pull, você pode examinar e discutir commits, arquivos alterados e as diferenças (ou "comparação") entre os arquivos nos branches base e de comparação.

Tool navigation

Neste artigo

Sobre revisões de pull requests

Você pode revisar as alterações em um arquivo de pull request por vez. Ao revisar os arquivos em um pull request, você pode deixar comentários individuais em alterações específicas. Após terminar de revisar cada arquivo, você pode marcar o arquivo como visualizado. Isso aninha o arquivo e ajuda a identificar os arquivos que ainda precisam ser revisadas. Uma barra de progresso no cabeçalho do pull request mostra o número de arquivos que você visualizou. Depois de revisar todos os arquivos você desejar, você pode aprovar a solicitação de pull ou solicitar alterações adicionais enviando a sua revisão com um comentário resumido.

Dica: encontre uma solicitação de pull na qual você ou uma equipe da qual você é membro é solicitada para revisão com o qualificador de pesquisa review-requested:[USERNAME] ou team-review-requested:[TEAMNAME]. Para obter mais informações, confira "Pesquisar problemas e pull requests".

Iniciar uma revisão

  1. Abaixo do nome do repositório, clique em Solicitações de pull.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  2. Na lista de solicitações pull, clique na solicitação pull que você quer revisar.

  3. Na solicitação de pull, clique em Arquivos alterados.

    Captura de tela das guias de uma solicitação de pull. A guia "Arquivos alterados" está contornada em laranja escuro.
    Você pode alterar o formato da visualização diff nesta guia clicando em e escolhendo a visualização dividida ou unificada. A escolha que você fizer será aplicada quando você visualizar o diff para outros pull requests.

    Captura de tela da guia "Arquivos alterados" de uma solicitação de pull. O menu "Exibição de comparação" está contornado em laranja escuro.

    Você também pode optar por ocultar as diferenças nos espaços em branco. A escolha que você fizer só se aplica a este pull request e será lembrada na próxima vez que você acessar esta página.

  4. Opcionalmente, filtre os arquivos para mostrar apenas aqueles que deseja examinar ou use a árvore de arquivos para acessar um arquivo específico. Para obter mais informações, confira "Filtrar arquivos em uma pull request".

  5. Opcionalmente, se você tiver acesso ao GitHub Copilot Enterprise, poderá perguntar ao Copilot sobre as alterações em um arquivo em uma pull request clicando em no canto superior direito do arquivo, clicando em Perguntar ao Copilot sobre essa comparação e digitando uma solicitação como "Explicar essas alterações". Para obter mais informações, confira "Asking GitHub Copilot questions in GitHub".

  6. Passe o mouse sobre a linha de código em que você gostaria de adicionar um comentário e clique no ícone de comentário azul.

    Captura de tela de uma comparação em uma solicitação de pull. Ao lado de um número de linha, um ícone de adição azul é realçado com um contorno laranja.

  7. Como alternativa, adicione um comentário em várias linhas. Selecione o número da linha da primeira linha que deseja comentar e arraste para baixo para selecionar um intervalo de linhas. Em seguida, selecione o ícone de comentário azul na última linha que deseja comentar. Como opção, você pode clicar no ícone de comentário azul ao lado da primeira linha que deseja comentar e, em seguida, arrastar para baixo até a última linha que deseja comentar.

  8. No campo comentário, digite o seu comentário.

  9. Opcionalmente, para sugerir uma alteração específica nas linhas, clique em e editr o texto no bloco de sugestão.

    Captura de tela de uma caixa de comentário de revisão. O ícone de comparação de arquivo usado para sugerir uma alteração específica está contornado em laranja escuro.

  10. Para comentar diretamente em um arquivo, à direita do arquivo, clique em e digite seu comentário.

    Captura de tela de um arquivo de imagem na página "Arquivos alterados" de uma PR. À direita do arquivo de imagem, um ícone de comentário está realçado com uma estrutura de tópicos laranja.

  11. Quando terminar, clique em Iniciar uma revisão. Se você já tiver iniciado uma revisão, clique em Adicionar comentário sobre a revisão.

Antes de enviar a revisão, os comentários em linha ficam com o status pendente e somente você pode visualizá-los. Você pode editar editar os comentários pendentes a qualquer momento antes de enviar a revisão. Para cancelar uma revisão pendente, incluindo todos os comentários pendentes, clique em Revisar alterações acima do código alterado e em Abandonar revisão.

Captura de tela do campo de comentário de uma revisão. O botão "Abandonar revisão" está contornado em laranja-escuro.

Use o GitHub Codespaces para testar, executar e examinar solicitações de pull.

  1. Abra a solicitação pull em um codespace, conforme descrito em "Como usar o GitHub Codespaces em solicitações de pull".

  2. Na barra de atividades, clique na exibição Solicitação de Pull do GitHub. Essa exibição só aparece quando você abre uma solicitação de pull em um codespace.

    Captura de tela da Barra de Atividades de VS Code. O ponteiro do mouse está passando o mouse sobre um ícone exibindo a dica de ferramenta "Solicitação de pull de GitHub".

  3. Para revisar um arquivo específico, clique no ícone Abrir Arquivo na barra lateral.

    Captura de tela da barra lateral de "Solicitação de pull do GitHub". O nome do arquivo é realçado com um contorno laranja escuro.

  4. Para adicionar comentários de revisão, clique no ícone + ao lado do número da linha. Digite seu comentário de revisão e clique em Iniciar Revisão.

    Captura de tela de um comentário sendo adicionado, lendo "Sim, eu concordo, assim está mais claro". O botão "Iniciar Revisão" é mostrado abaixo do comentário.

  5. Opcionalmente, você pode sugerir uma alteração em que o autor do pull request pode clicar para confirmar se concordar com sua sugestão. Para fazer isso, clique e mantenha pressionado o sinal + ao lado da primeira linha em que você deseja sugerir a alteração e, em seguida, arraste o sinal + para a última linha em que você deseja sugerir a alteração. Em seguida, clique em Fazer uma sugestão na caixa de comentários exibida.

    As linhas selecionadas são copiadas para a caixa de comentários, onde você pode editá-las para sugerir uma alteração. Você pode adicionar um comentário acima da linha que contém ```suggestion para explicar a alteração sugerida.

    Clique em Adicionar comentário para adicionar sua sugestão ao pull request.

    Captura de tela de uma alteração sugerida. Os botões "Fazer uma sugestão" e "Adicionar comentário" são mostrados abaixo da alteração sugerida.

  6. Quando terminar de adicionar comentários de revisão, na barra lateral, você poderá optar por enviar os comentários, aprovar as alterações ou solicitar alterações.

    Captura de tela da barra lateral mostrando as opções suspensas "Comentar e Enviar", "Aprovar e Enviar" e "Solicitar Alterações e Enviar".

Para obter mais informações sobre como revisar solicitações de pull no GitHub Codespaces, confira "Como usar o GitHub Codespaces em solicitações de pull".

Revisar alterações de dependência

Se o pull request contiver alterações em dependências, você poderá usar a revisão de dependências para um manifesto ou arquivo de bloqueio para ver o que mudou e verificar se as alterações introduzem vulnerabilidades de segurança. Para obter mais informações, confira "Revendo alterações de dependência em um pull request".

  1. Na solicitação de pull, clique em Arquivos alterados.

    Captura de tela das guias de uma solicitação de pull. A guia "Arquivos alterados" está contornada em laranja escuro.

  2. À direita do cabeçalho de um arquivo de manifesto ou de bloqueio, veja a revisão de dependências clicando no botão de comparação avançada .

    Captura de tela da guia "Arquivos alterados" de uma solicitação de pull. O botão usado para exibir a comparação sofisticada, rotulada com um ícone de arquivo, está contornado em laranja escuro.

  3. É possível que você também queira revisar o diff da fonte, porque pode haver alterações no manifesto ou arquivo de bloqueio que não mudam as dependências, ou pode haver dependências que GitHub não pode analisar e que, consequentemente, não aparecem na revisão de dependências.

    Para voltar à exibição de comparação de origem, clique no botão .

    Captura de tela da guia "Arquivos alterados" de uma solicitação de pull. O botão usado para exibir a comparação de origem, rotulada com um ícone de código, está contornado em laranja escuro.

Marcar um arquivo como visualizado

Quando terminar de revisar um arquivo, você pode marcar o arquivo como visualizado, e o arquivo será aninhado. Se o arquivo for alterado após ser visualizado, será desmarcado como visualizado.

  1. Na solicitação de pull, clique em Arquivos alterados.

    Captura de tela das guias de uma solicitação de pull. A guia "Arquivos alterados" está contornada em laranja escuro.

  2. À direta do cabeçalho do arquivo que você terminou de revisar, selecione Visualizado.

    Captura de tela do cabeçalho de um arquivo. A opção "Exibido" está contornada em laranja escuro.

Enviar a revisão

Quando terminar de revisar os arquivos que deseja incluir na pull request, envie a revisão.

  1. Na solicitação de pull, clique em Arquivos alterados.

    Captura de tela das guias de uma solicitação de pull. A guia "Arquivos alterados" está contornada em laranja escuro.

  2. Acima do código alterado, clique em Revisar alterações.

    Captura de tela da guia "Arquivos alterados" de uma solicitação de pull. O botão "Revisar alterações" está contornado em laranja escuro.

  3. Digite um comentário que resume o seu feedback sobre as alterações propostas.

  4. Selecione o tipo de revisão que você gostaria de deixar:

    • Selecione Comentar para incluir um comentário geral sem aprovar explicitamente as alterações nem solicitar alterações adicionais.
    • Selecione Aprovar para enviar seu comentário e aprovar a mesclagem das alterações propostas na solicitação de pull.
    • Selecione Solicitar alterações para enviar comentários que precisam ser resolvidos para que a solicitação de pull seja mesclada.

  5. Clique em Enviar revisão.

Dicas:

  • A opção Solicitar alterações é puramente informativa e não impedirá a mesclagem, a menos que um conjunto de regras ou regra de proteção de branch clássica seja configurado com a opção "exigir uma pull request". Se estiver cofnfigurado e um colaborador com acesso admin, owner ou write no repositório enviar uma revisão solicitando alterações, a solicitação de pull não poderá ser mesclada até que o mesmo colaborador envie outra revisão aprovando as alterações na pull request.
  • Proprietários e administradores do repositório podem fazer merge de um pull request mesmo que não tenham recebido uma revisão de aprovação; ou se um revisor que solicitou alterações saiu da organização ou estiver indisponível.
  • Se as revisões necessárias e o descarte de uma revisão obsoleta estiverem habilitados e um commit de modificação de código for enviado para o branch de um pull request aprovado, a aprovação será ignorada. O pull request deve ser revisado e aprovado novamente antes de poder ser mesclado.
  • Quando vários pull requests abertos têm um branch principal que aponta para o mesmo commit, você não conseguirá mesclá-los se um ou ambos tiverem uma revisão pendente ou rejeitada.
  • Se o repositório exigir a aprovação de revisões de pessoas com permissões de gravação ou de administrador, todas as aprovações de pessoas com essas permissões serão indicadas com uma marca de seleção verde e as aprovações de pessoas sem essas permissões têm uma marca de seleção cinza. As aprovações com uma marca de seleção cinza não afetam a possibilidade de mesclagem da solicitação de pull.
  • Os autores de pull request não podem aprovar seus próprios pull requests.

Leitura adicional