Gerenciando branches em seu repositório

Crie novas ramificações para desenvolvimento e exclua as ramificações não utilizadas diretamente no GitHub.

Neste artigo

Criando um ramo

Crie um branch para um local separado para trabalhar em alterações antes de abrir uma solicitação de pull.

Observação

Você só pode criar uma ramificação em um repositório ao qual tem acesso de escrita.

Criar um ramo por meio da visão geral dos ramos

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

  2. Na exibição da árvore de arquivos à esquerda, selecione o menu suspenso do branch e clique em View all branches. Você também pode encontrar o menu suspenso do branch na parte superior do editor de arquivos integrado.

    Captura de tela do modo de exibição de árvore de arquivos de um repositório. Há um menu suspenso para branches expandido e realçado em laranja escuro.

  3. Clique em Criar ramificação.

    Captura de tela da página "Branches" para um repositório. Um botão verde, com o rótulo "Nova ramificação", é destacado com um contorno laranja.

  4. Em "Novo nome da ramificação", digite um nome para a ramificação.

  5. Em "Origem", escolha a branch que servirá de base para sua nova branch.

  6. Clique em Criar nova ramificação.

Criar um branch usando a lista suspensa de branch

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

  2. Selecione o menu suspenso do branch, na visualização em árvore de arquivos ou na parte superior do editor de arquivos integrado.

    Captura de tela do modo de exibição de árvore de arquivos de um repositório. Há um menu suspenso para ramificações delimitado em laranja escuro.

  3. Opcionalmente, para criar o novo branch a partir de um branch diferente do branch padrão do repositório, clique em outro branch. Em seguida, selecione o menu suspenso da ramificação novamente.

  4. No campo de texto "Localizar ou criar um branch...", digite um nome exclusivo para seu novo branch e clique em Criar branch.

    Captura de tela do menu suspenso do seletor de ramificação. "Criar branch: new-branch" é realçado com um contorno laranja.

Criando uma ramificação para uma tarefa

Você pode criar uma ramificação para trabalhar em um item diretamente da página do item. Consulte Criando um ramo para trabalhar em uma tarefa.

Excluir um ramo

Exclua as ramificações de que você não precisa mais, como as ramificações de trabalhos mesclados ou encerrados.

É possível excluir branches head automaticamente após a mesclagem de solicitações de pull no repositório. Consulte Gerenciar a exclusão automática de branches.

Observação

Se o branch que você deseja excluir for o branch padrão do repositório, escolha um novo branch padrão primeiro. Consulte Alterar o ramo padrão.

Se o branch estiver associado a uma solicitação de pull aberta, mescle ou feche a solicitação de pull antes de excluir o branch.

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

  2. Na exibição da árvore de arquivos à esquerda, selecione o menu suspenso do branch e clique em View all branches. Você também pode encontrar o menu suspenso do branch na parte superior do editor de arquivos integrado.

    Captura de tela do modo de exibição de árvore de arquivos de um repositório. Há um menu suspenso para branches expandido e realçado em laranja escuro.

  3. Ao lado da ramificação que você deseja excluir, clique em .

    Captura de tela de um branch na lista de ramificações. Um ícone de lixeira é realçado com um contorno laranja.

  4. Se a ramificação estiver associada a pelo menos uma solicitação de pull aberta, a exclusão da ramificação fechará as solicitações de pull. Leia o aviso e clique em Excluir.

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

Leitura adicional