Skip to main content

Mesclar uma solicitação de pull

Mesclar solicitações de pull no branch upstream, escolher métodos de mesclagem e atender aos requisitos do repositório, como revisões ou verificações de status.

Tool navigation

Sobre fusões de pull-request

Mesclar uma solicitação de pull quando as alterações propostas estiverem prontas e todos os requisitos do repositório forem atendidos. Você não pode realizar o merge de um rascunho de um pull request.

As regras do repositório ou a proteção de ramificação podem exigir revisões, verificações de status ou uma ramificação atualizada antes de mesclar. Consulte 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 branch, como status e melhor capacidade de descoberta sem a necessidade de 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 a ramificação base exigir uma fila de mesclagem, as opções de mesclagem disponíveis serão diferentes das descritas aqui. Consulte Como mesclar uma pull request com uma fila de mesclagem.

Se a solicitação de pull tiver conflitos de mesclagem ou se você quiser testar as alterações primeiro, confira a solicitação de pull localmente.

O repositório pode excluir automaticamente o branch principal após a mesclagem. Consulte 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.

As solicitações de pull usam a opção--no-ff, exceto solicitações de pull esmagadas ou rebased, que usam a mesclagem 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ê não quiser mesclar as alterações, poderá fechar a solicitação de pull.

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 "Solicitações de Pull", clique na solicitação de pull que você deseja mesclar.

  3. Role a página até o final do pull request. Dependendo das opções de mesclagem habilitadas para seu repositório, escolha um método de mesclagem:

    Observação

    Rebase e mesclagem sempre atualizarão as informações do committer e criarão novos SHAs de commit. Consulte sobre mesclagens de solicitação de pull.

  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 Fusão de Pull Requests.

  5. Se você tiver mais de um endereço de e-mail associado à sua conta no GitHub, clique no menu suspenso de endereço de e-mail e selecione o endereço de e-mail a ser usado como endereço de e-mail do autor no 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 um pull request do GitHub mostrando um menu suspenso com opções para escolher o endereço de e-mail do autor do commit.
octocat@github.com está selecionado.

Observação

O seletor de email não está disponível para mesclagens de rebase, que não criam uma confirmação de mesclagem. Para mesclagens por squash, o seletor de e-mail só é exibido se você for o autor do pull request e tiver mais de um endereço de e-mail associado à sua conta.

  1. Clique em Confirmar mesclagem, Confirmar squash e mesclagem ou Confirmar rebase e mesclagem.
  2. 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. Consulte Fusão de Pull Requests.

Como alternativa, você pode usar sinalizadores para ignorar as instruções interativas. Por exemplo, esse comando esmaga as confirmações em uma única confirmação com a mensagem de confirmação "my squash commit", mescla a confirmação esmagada no branch base e exclui o branch local e remoto.

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

Leitura adicional