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, 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

Dica: O primeiro branch que você criar 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, em seguida, clique na lista de branches, e depois clique no branch em que você deseja basear seu novo branch. Menu suspenso para alternar o branch atual
  2. Clique em New Branch (Novo branch). Opção New Branch (Novo branch) no menu Branch
  3. Em Name (nome), digite o nome do novo branch. Campo para criar um nome para o novo branch
  4. Use o menu suspenso para escolher um branch de base para seu novo branch. Opções do branch base
  5. Clique em Create Branch (Criar branch). Botão Create Branch (Criar branch)
  1. Na parte superior do aplicativo, clique em Branch atual e, em seguida, clique na lista de branches, e depois clique no branch em que você deseja basear seu novo branch. Menu suspenso para alternar o branch atual
  2. Clique em New Branch (Novo branch). Opção New Branch (Novo branch) no menu Branch
  3. Em Name (nome), digite o nome do novo branch. Campo para criar um nome para o novo branch
  4. Use o menu suspenso para escolher um branch de base para seu novo branch. Opções do branch base
  5. Clique em Create Branch (Criar branch). Botão Create branch (Criar branch)

Criando um branch de um commit anterior

  1. Clique em History (Histórico). Aba history (histórico) selecionada na barra lateral
  2. Clique com o botão direito no commit a partir do qual você gostaria de criar um novo branch e selecione Criar Branch a partir de Commit. Criar branch a partir do menu de contexto de commit
  3. Em Name (nome), digite o nome do novo branch.
  4. Clique em Create Branch (Criar branch). Criar branch a partir do 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, em seguida, clique no branch que você deseja publicar. Menu suspenso para selecionar qual branch publicar
  2. Clique em Publicar branch. Botão de 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."

Dica: Você pode definir um comportamento-padrão para alternar branches nas configurações Avançadas. Para obter mais informações, consulte "Definindo as configurações básicas".

  1. No GitHub Desktop, clique em Branch atual. Menu suspenso Current Branch (Branch atual)
  2. Na lista de branches, clique no branch para o qual você quer mudar. Lista de branches no repositório
  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). Alternar branch com opções de alteração

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, em seguida, clique no branch que você deseja excluir. Menu suspenso para selecionar qual branch deseja excluir
  2. Na sua barra de menu, clique em Branch e, em seguida, clique em Excluir.... Você também pode pressionar shift⌘ commandD. Excluir... opção no menu do branch
  1. Na parte superior do aplicativo, clique em Branch atual e, em seguida, clique no branch que você deseja excluir. Menu suspenso para selecionar qual branch deseja excluir
  2. Na sua barra de menu, clique em Branch e, em seguida, clique em Excluir.... Você também pode pressionar CtrlShiftD. Excluir... opção no menu do branch

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.