Gerenciar branches

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.

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, consulte "Criar um problema ou pull request" e "Sobre pull requests".

É 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, consulte "Sobre branches protegidos".

Criar um branch

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, em seguida, clique no branch que você deseja publicar.
   
2. Clique em 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. Se você deseja confirmar suas alterações antes de alternar os branches, consulte "Fazer commit e revisar as alterações do seu projeto."

1. No GitHub Desktop, clique em Branch atual.
   
2. Na lista de branches, clique no branch para o qual você quer mudar.
   
3. Se você tiver alterações salvas sem commit, escolha entre Leave my changes (Deixar as alterações) ou Bring my changes (Levar as alterações) e clique em Switch Branch (Alternar branch).
   

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.

Leia mais

• "Clonar um repositório no GitHub Desktop"
• "Branch" no glossário do GitHub
• "Sobre branches"
• "Branches em um Nutshell" na documentação do Git
• "Ocultar as alterações