Menu
Coddy logo textTech

Git: Clonar um branch específico

Última atualização

Por padrão, o git clone faz o checkout do branch padrão do repositório (geralmente main), mas baixa todos os branches. Para começar em um branch diferente, adicione -b <branch>. Para buscar apenas esse branch e ignorar os demais - útil em repositórios grandes ou em CI - passe também --single-branch.

Experimente estes comandos no playground de terminal - um shell real no seu navegador, sem nada para instalar.

git clone -b faz checkout do branch que você indicar; com --single-branch apenas o histórico desse branch é baixado.

Sintaxe

CommandWhat it does
git clone -b dev <url>Clona e faz o checkout do branch dev
git clone -b dev --single-branch <url>Clona apenas o histórico do branch dev
git clone <url> then git switch devClona tudo e depois troca de branch

Qual abordagem usar

GoalCommand
Começar em um branch e manter todos os branchesgit clone -b dev <url>
Só precisa de um branchgit clone -b dev --single-branch <url>
Já clonou e quer outro branchgit fetch then git switch dev

Perguntas frequentes sobre clonar um branch específico no Git

Como clono um branch específico no Git?
Execute git clone -b <branch> <url> (ou a forma longa --branch). O Git clona o repositório e faz o checkout do branch que você indicou em vez do padrão. Todos os outros branches ainda são baixados, a menos que você também passe --single-branch.
Como clono apenas um branch e nada mais?
Combine as flags: git clone -b <branch> --single-branch <url>. Isso busca apenas o histórico do branch especificado, ignorando todos os outros - um clone menor e mais rápido, útil para repositórios grandes ou pipelines de CI que só precisam de um branch.
Posso trocar para outro branch após um clone de branch único?
Não diretamente, porque os outros branches não foram buscados. Primeiro diga ao Git para buscá-los - git remote set-branches origin '*' e depois git fetch - após o que você pode usar git switch para qualquer branch. Se você prevê precisar de vários branches, faça um clone normal.
Qual é a diferença em relação a simplesmente clonar e trocar de branch?
Um git clone <url> simples seguido de git switch <branch> dá a você todos os branches e depois move para o que deseja - adequado para o uso normal. O git clone -b já começa naquele branch imediatamente e, com --single-branch, também evita baixar o restante.
Posso praticar isso online?
Sim. Abra o playground de terminal para executar git clone em um shell real no seu navegador - sem nada para instalar. O curso interativo e gratuito de Git da Coddy também mostra como obter um repositório passo a passo.
Coddy programming languages illustration

Aprenda Git com a Coddy

COMEÇAR