Skip to main content

Gerenciar branches

Você pode criar um branch fora do branch-padrão de um repositório para poder experimentar as alterações com segurança.

Sobre o gerenciamento de branches

Você pode usar os branches para experimentar com segurança as alterações no seu projeto. Os branches isolam seu trabalho de desenvolvimento de outros branches do repositório. Por exemplo, você poderia usar um branch para desenvolver um novo recurso ou corrigir um erro.

Você sempre cria um branch a partir de um branch existente. Normalmente, você pode criar um branch a partir do branch-padrão do seu repositório. Você então poderá trabalhar nesse novo branch isolado das mudanças que outras pessoas estão fazendo no repositório.

Você também pode criar um branch a partir de um commit anterior no histórico de um branch. Isso pode ser útil se você precisar retornar a uma visão anterior do repositório para investigar um erro ou para criar uma correção em cima de sua versão mais recente.

Quando estiver satisfeito com seu trabalho, você poderá criar um pull request para fazer merge nas suas alterações no branch atual em outro branch. Para obter mais informações, confira "Como criar um problema ou uma solicitação de pull" e "Sobre as solicitações de pull".

É sempre possível criar um branch no GitHub Desktop, se tiver acesso de leitura a um repositório, mas você só pode fazer push do branch para o GitHub se você tiver acesso de gravação no repositório.

Os administradores de repositório podem habilitar proteções em um branch. Se estiver trabalhando em um branch que é protegido, não será possível excluir nem forçar o push no branch. Os administradores de repositório podem ativar outras configurações protegidas de branch para aplicar fluxos de trabalho específicos antes que um branch possa ser mesclado. Para obter mais informações, confira "Sobre os branches protegidos".

Criar um branch

Dica: o primeiro branch criado será baseado no branch padrão. Se você tiver mais de um branch, você pode escolher basear o novo branch no branch atualmente verificado ou no branch-padrão.

  1. Na parte superior do aplicativo, clique em Branch Atual e, na lista de branches, clique no branch no qual deseja basear o novo branch. Menu suspenso usado para alternar o branch atual 1. Clique em Novo Branch. Opção Novo Branch no menu Branch 1. Em Nome, digite o nome do novo branch. Campo usado para criar um nome para o novo branch 1. Use o menu suspenso para escolher um branch de base para seu novo branch. Opções do branch base 1. Clique em Criar Branch. Botão Criar Branch
  1. Na parte superior do aplicativo, clique em Branch Atual e, na lista de branches, clique no branch no qual deseja basear o novo branch. Menu suspenso usado para alternar o branch atual 1. Clique em Novo Branch. Opção Novo Branch no menu Branch 1. Em Nome, digite o nome do novo branch. Campo usado para criar um nome para o novo branch 1. Use o menu suspenso para escolher um branch de base para seu novo branch. Opções do branch base 1. Clique em Criar Branch. Botão Criar branch

Criando um branch de um commit anterior

  1. Clique em Histórico. Aba histórico selecionada na barra lateral
  2. Clique com o botão direito do mouse no commit com base no qual deseja criar um branch e selecione Criar Branch com base no Commit. Menu de contexto Criar branch com base no commit 1. Em Nome, digite o nome do novo branch. 1. Clique em Criar Branch. Criar branch com base no commit

Publicar um branch

Se você criar um branch no GitHub, você deverá publicá-lo para disponibilizá-lo para colaboração no GitHub.

  1. Na parte superior do aplicativo, clique em Branch Atual e clique no branch que deseja publicar. Menu suspenso usado para selecionar o branch que será publicado
  2. Clique em Publicar branch. Botão Publicar branch

Alternar entre branches

É possível exibir e fazer commits em qualquer branch do seu repositório. Se houver alterações salvas sem commit, você terá que decidir o que fazer com elas antes de poder alternar entre os branches. Você pode fazer o commit das alterações no branch atual, ocultar as suas alterações para salvá-las temporariamente no branch atual ou trazer as mudanças para seu novo branch. Caso deseje fazer commit das alterações antes de alternar branches, confira "Como fazer commit de alterações no seu projeto e revisá-las".

Dica: você pode definir um comportamento padrão para alternar branches nas configurações Avançadas. Para obter mais informações, confira "Como definir configurações básicas".

  1. No GitHub Desktop, clique em Branch Atual. Menu suspenso Branch Atual 1. Na lista de branches, clique no branch para o qual deseja alternar. Lista de branches no repositório
  2. Se você tiver alterações salvas e sem commit, escolha Manter minhas alterações ou Levar minhas alterações e clique em Alternar Branch. Alternar branch com opções de alterações

Excluir um branch

Não é possível excluir um branch se ele estiver atualmente associado a uma pull request aberta. Não é possível desfazer a exclusão de um branch.

  1. Na parte superior do aplicativo, clique em Branch Atual e clique no branch que deseja excluir. Menu suspenso usado para selecionar o branch que será excluído 1. Na barra de menus, clique em Branch e em Excluir... . Você também pode pressionar Shift+Command+D. Opção Excluir… no menu Branch
  1. Na parte superior do aplicativo, clique em Branch Atual e clique no branch que deseja excluir. Menu suspenso usado para selecionar o branch que será excluído 1. Na barra de menus, clique em Branch e em Excluir... . Você também pode pressionar Ctrl+Shift+D. Opção Excluir… no menu Branch

Leitura adicional