Mesclar uma solicitação de pull

Faça merge de uma pull request no branch upstream quando o trabalho estiver finalizado. Qualquer pessoa com acesso push no repositório pode completar o merge.

Tool navigation

Neste artigo

Sobre fusões de pull-request

Em uma pull request, você propõe que as alterações feitas em um branch head sejam mescladas em um branch base. Por padrão, qualquer pull request pode sofrer merge a qualquer momento, a menos que o branch head esteja em conflito com o branch base. No entanto, pode haver restrições sobre quando você pode mesclar um pull request em um ramo específico. Por exemplo, você só pode fazer merge de um pull request no branch-padrão se as verificações de status necessárias forem aprovadas. Os administradores do repositório podem adicionar restrições como essa às ramificações usando regras de proteção de ramificação. Para saber mais, confira Sobre branches protegidos.

Como alternativa às regras de proteção de branch, você pode criar conjuntos de regras. Os conjuntos de regras têm algumas vantagens em relação às regras de proteção de branches, como status, e melhor capacidade de detecção sem exigir acesso de administrador. Você também pode aplicar vários conjuntos de regras ao mesmo tempo. Para saber mais, confira Sobre os conjuntos de regras.

Você pode configurar um pull request para fazer merge automaticamente quando todos os requisitos de merge forem atendidos. Para saber mais, confira Mesclar automaticamente uma pull request.

Se o pull request tiver conflitos de mesclagem ou se você quiser testar as alterações antes de mesclar, busque o pull request localmente e mescle-o usando o terminal.

Você não pode realizar o merge de um rascunho de um pull request. Para obter mais informações sobre rascunhos de solicitações de pull, confira Sobre solicitação de pull.

O repositório pode ser configurado para que o branch principal de um pull request seja excluído automaticamente quando você faz o merge de um pull request. Para saber mais, confira Gerenciar a exclusão automática de branches.

Observação

Se você excluir um branch de cabeçalho após o merge do seu pull request, o GitHub irá verificar se há quaisquer solicitações de pull no mesmo repositório que especificam o branch excluído como o branch base. O GitHub atualiza automaticamente quaisquer pull requests, alterando o branch base para o branch base do pull request mesclado. Para saber mais, confira Sobre ramificações.

As solicitações de pull são mescladas por meio da opção --no-ff, exceto as solicitações de pull que têm commits com mesclagem squash ou com troca de base, que são mescladas por meio da opção de avanço rápido.

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.

Se você decidir que não deseja que as alterações em um branch do tópico sejam mescladas com o branch upstream, feche a solicitação de pull sem mesclá-la.

Mesclar uma solicitação de pull

  1. Abaixo do nome do repositório, clique em Pull requests.

    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 "Pull Requests", clique na solicitação de pull que deseja mesclar.

  3. Role a página até o final do pull request. Dependendo das opções de merge habilitadas em seu repositório, é possível:

    •           [Mescle todos os commits na ramificação base](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges) clicando em **Mesclar solicitação de pull**. Se a opção **Mesclar solicitação de pull** não for mostrada, clique no menu suspenso Mesclar e selecione **Criar um commit de mesclagem**.

      Captura de tela das opções de mesclagem para uma solicitação de pull. A seta usada para expandir o menu suspenso está contornada em laranja escuro.

    •           [Compacte os commits em um único commit](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#squash-and-merge-your-pull-request-commits) clicando no menu suspenso de mesclagem, selecionando **Compactar e mesclar** e, em seguida, clicando novamente em **Consolidar e mesclar**.

    •           [Troque a base dos commits individualmente na ramificação base](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#rebase-and-merge-your-pull-request-commits) clicando no menu suspenso Mesclar, selecionando **Trocar a base e mesclar** e clicando no menu suspenso **Trocar a base e mesclar**.

    Observação

    A troca de base e a mesclagem sempre atualizarão as informações do autor da confirmação e criarão novos SHAs de commit. Para obter mais informações, confira Sobre as mesclagens de pull requests.

  4. Se solicitado, digite uma mensagem de commit ou aceite a mensagem padrão.

    Para obter informações sobre as mensagens de commit padrão para mesclagens squash, confira Sobre fusões de pull-request.

  5. Se você tiver mais de um endereço de email associado à sua conta em GitHub, clique no menu suspenso do endereço de email e selecione o email a ser usado como o endereço de email do autor do Git. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você habilitou a privacidade do endereço de email, um email sem resposta será o endereço de email do autor de commit padrão. Para obter mais informações sobre a forma exata que o endereço de email sem resposta pode assumir, confira Configurar o endereço de e-mail do commit.

    Captura de tela de uma solicitação de pull do GitHub que mostra um menu suspenso com opções para escolher o endereço de email do autor do commit. octocat@github.com está selecionado.

    Observação

    O seletor de e-mail não está disponível para mesclagens de troca de base, que não criam um commit de mesclagem. Para as mesclagens squash, o seletor de email só será mostrado se você for o autor da solicitação de pull e tiver mais de um endereço de email associado à sua conta.

  6. Clique em Confirmar mesclagem, Confirmar mesclagem squash e mesclagem ou Confirmar troca de base e mesclagem.

  7. Opcionalmente, exclua o branch. Isso mantém a lista de branches no seu repositório organizada.

Observação

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

Para mesclar uma solicitação de pull, use o subcomando gh pr merge. Substitua pull-request pelo número, pela URL ou pelo branch principal do pull request.

gh pr merge PULL-REQUEST

Siga as instruções interativas para realizar o merge. Para obter mais informações sobre os métodos de mesclagem que você pode escolher, confira Sobre fusões de pull-request.

Como alternativa, você pode usar sinalizadores para ignorar as instruções interativas. Por exemplo, esse comando fará a combinação por squash dos commits em um único commit com a mensagem de "my squash commit", faça o merge do commit combinado por squash no branch de base e exclua o branch local e o remoto.

gh pr merge 523 --squash --body "my squash commit" --delete-branch

Leitura adicional

  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/reverting-a-pull-request)

  •         [AUTOTITLE](/desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch) utilizando GitHub Desktop

  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges)

  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts)