Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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.

Neste artigo

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.

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

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)

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 commit das alterações no branch atual, armazená-las no branch atual ou levá-las para o novo branch. Se optar por fazer commit das alterações no branch atual, siga as etapas indicadas em "Fazer commit e revisar as alterações do projeto" antes de alternar entre os branches.

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

Recuperar alterações stashed

Para acessar as alterações com stash em outro branch, volte para o branch em que foi feito o stash das alterações em questão.

  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. Na barra lateral à esquerda, clique em Stashed Changes (Alterações stashed).
    Opção Stashed Changes (Alterações stashed)
  4. Para excluir as alterações stashed, clique em Discard (Descartar). Para usá-las, clique em Restore (Restaurar).
    Descartar ou restaurar alterações stashed

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

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Ou, learn how to contribute.