Managing branches within your repository

Create new branches for development and delete unused branches directly on GitHub.

Neste artigo

Creating a branch

Create a branch for a separate place to work on changes before opening a pull request.

Observação

You can only create a branch in a repository to which you have write access.

Creating a branch via the branches overview

  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. Click New branch.

    Screenshot of the "Branches" page for a repository. A green button, labeled "New branch", is highlighted with an orange outline.

  4. Under "Branch name", type a name for the branch.

  5. Under "Branch source", choose the repository and branch to base your new branch on.

  6. Click Create branch.

Creating a branch using the branch dropdown

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

  2. Select the branch dropdown menu, in the file tree view or at the top of the integrated file editor.

    Screenshot of the file tree view for a repository. A dropdown menu for branches is outlined in dark orange.

  3. Optionally, to create the new branch from a branch other than the default branch of the repository, click another branch. Then, select the branch dropdown menu again.

  4. In the "Find or create a branch..." text field, type a unique name for your new branch, then click Create branch.

    Screenshot of the branch selector dropdown menu. "Create branch: new-branch" is highlighted with an orange outline.

Creating a branch for an issue

You can create a branch to work on an issue directly from the issue page. See Criando um ramo para trabalhar em uma tarefa.

Deleting a branch

Delete branches that you no longer need, such as branches for merged or closed work.

É possível excluir automaticamente as branches de origem após a mesclagem de pull requests no seu repositório. Consulte Gerenciar a exclusão automática de branches.

Observação

If the branch you want to delete is the repository's default branch, choose a new default branch first. See Alterar o ramo padrão.

If the branch is associated with an open pull request, merge or close the pull request before deleting the 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. Next to the branch that you want to delete, click .

    Screenshot of a branch in the branch list. A trash icon is highlighted with an orange outline.

  4. If the branch is associated with at least one open pull request, deleting the branch closes the pull requests. Read the warning, then click Delete.

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

Further reading