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

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 mestredo 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. Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. Para obter mais informações, consulte "Sobre branches protegidos".

Criar um branch

Dica: o primeiro branch que você criar terá como base o branch padrão, que costuma ser master. Se você tiver mais de um branch, você pode escolher basear o novo branch no branch atualmente verificado ou no branch-padrão.

  1. At the top of the app, click Current Branch and then in the list of branches, click the branch that you want to base your new branch on.
    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. Selecione o branch atual ou o branch padrão (normalmente, o mestre) no qual basear o novo branch.
    Opções do branch base
  5. Clique em Create Branch (Criar branch).
    Botão Create Branch (Criar branch)
  1. At the top of the app, click Current Branch and then in the list of branches, click the branch that you want to base your new branch on.
    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. Selecione o branch atual ou o branch padrão (normalmente, o mestre) no qual basear o 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. In GitHub Desktop, click Current Branch.
    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. In GitHub Desktop, click Current Branch.
    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. At the top of the app, click Current Branch, then click the branch that you want to delete.
    Menu suspenso para selecionar qual branch deseja excluir
  2. In your menu bar, click Branch, then click Delete.... You can also press shift⌘ commandD.
    Excluir... opção no menu do branch
  1. At the top of the app, click Current Branch, then click the branch that you want to delete.
    Menu suspenso para selecionar qual branch deseja excluir
  2. In your menu bar, click Branch, then click Delete.... You can also press CtrlShiftD.
    Excluir... opção no menu do branch

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato