Skip to main content

Como criar uma solicitação de pull

Crie uma solicitação de pull para propor alterações ao código em um repositório.

Quem pode usar esse recurso?

Anyone with read access to a repository can create a pull request.

Se você deseja criar uma nova ramificação para sua pull request request, mas não tem permissões de escrita no repositório, você pode primeiro fazer um fork do repositório. Confira Creating a pull request from a fork e Garfos.

Ao criar sua solicitação de pull, você pode especificar em qual branch deseja mesclar suas alterações. As pull requests só podem ser abertas entre duas ramificações diferentes.

Você pode vincular uma solicitação de pull a um problema para mostrar que uma correção está em andamento e fechar automaticamente o problema quando a solicitação de pull é mesclada. Para saber mais, confira Vinculando uma pull request a um problema.

Criando a solicitação de pull

  1. Em GitHub, acesse a página principal do repositório.

  2. No menu "Branch", escolha o branch que contém seus commits.

    Captura de tela do menu suspenso do branch na página principal de um repositório.

  3. Acima da lista de arquivos, na faixa amarela, clique em Comparação e solicitação de pull para criar uma solicitação de pull para o branch associado.

    Captura de tela da faixa acima da lista de arquivos.

  4. Use o menu suspenso base ramificação para selecionar a ramificação onde você deseja mesclar suas alterações. Em seguida, use o menu suspenso compare ramificação para escolher a ramificação de tópico onde você fez suas alterações.

  5. Digite um título e uma descrição para a pull request.

  6. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Se você for membro de uma organização, talvez seja necessário solicitar acesso a pull requests de rascunho a um proprietário da organização. Confira Solicitações de pull.

Dica

Depois de criar uma pull request, solicite a uma pessoa específica que revise suas alterações propostas. Para saber mais, confira Solicitando revisão de pull request.

Após a revisão do seu pull request, ele poderá ser incorporado ao repositório. Consulte Mesclar uma solicitação de pull.

Observação

Para saber mais sobre GitHub CLI, confira Sobre GitHub CLI.

Para criar uma solicitação de pull, use o subcomando gh pr create.

gh pr create

Para atribuir uma solicitação de pull a uma pessoa, use o sinalizador --assignee ou -a. Você pode usar @me para atribuir a solicitação de pull automaticamente.

gh pr create --assignee "@octocat"

Para especificar o branch no qual deseja mesclar a solicitação de pull, use o sinalizador --base ou -B. Para especificar o branch que contém os commits da sua solicitação de pull, use o sinalizador --head ou -H.

gh pr create --base my-base-branch --head my-changed-branch

Para incluir um título e um corpo na nova solicitação de pull, use os sinalizadores --title e --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Para marcar um pull request como rascunho, use o sinalizador --draft.

gh pr create --draft

Para adicionar rótulos ou marcos à nova pull request request, use as flags --label e --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Para adicionar a nova solicitação de pull a um projeto específico, use o sinalizador --project.

gh pr create --project octocat-project

Para atribuir uma pessoa ou uma equipe como revisor, use o sinalizador --reviewer.

gh pr create --reviewer monalisa,hubot --reviewer myorg/team-name

Para criar a solicitação de pull no navegador da Web padrão, use o sinalizador --web.

gh pr create --web
  1. Clique em Visualizar Pull Request. GitHub Desktop abre uma caixa de diálogo de pré-visualização que mostra a diferença das alterações entre sua ramificação atual e a ramificação base.

    Como alternativa, para ir direto para GitHub e criar seu pull request, selecione o ícone de menu suspenso e clique em Criar Pull Request.

  2. Confirme se o branch no menu suspenso base: é o branch em que deseja mesclar as alterações.

    Captura de tela da janela de diálogo "Abrir uma Solicitação de Pull". Um botão com um ícone suspenso, rotulado "base: desenvolvimento", está contornado em laranja.

GitHub Desktop indica se a ramificação atual pode ser mesclada automaticamente à ramificação base.

Captura de tela da janela de diálogo "Abrir uma Solicitação de Pull". Um rótulo de status informando "Não é possível fazer a mesclagem automaticamente" está realçado com um contorno em laranja.

  1. Clique em Criar Solicitação de Pull. GitHub Desktop abre seu navegador padrão e leva você para GitHub.
  2. Digite um título e uma descrição para a pull request.
  3. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Se você for membro de uma organização, talvez seja necessário solicitar acesso a pull requests de rascunho a um proprietário da organização. Confira Solicitações de pull.

Como fazer alterações em arquivos na pull request

Depois de abrir sua pull request request, você pode continuar alterando arquivos adicionando novos commits à sua ramificação principal.

Você também pode fazer alterações nos arquivos no GitHub site.

  1. No GitHub, navegue até uma pull request em um repositório.

  2. Na pull request, clique em Files changed.

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

  3. Role a página para baixo até o arquivo no qual deseja fazer alterações.

    • Se a pull request tiver muitos arquivos, você poderá usar o filtro para localizar o arquivo.
  4. Acima do arquivo que você deseja alterar, clique em .

Captura de tela das opções acima de um arquivo na guia “Arquivo alterado”. O botão “Mostrar opções” está realçado com um retângulo laranja.

  1. No menu, selecione Editar arquivo.
  2. Faça suas alterações no editor. Ao confirmar sua alteração, escolha confirmar diretamente na sua ramificação principal.

Leitura adicional