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.
Sintaxe
| Command | What 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 dev | Clona tudo e depois troca de branch |
Qual abordagem usar
| Goal | Command |
|---|---|
| Começar em um branch e manter todos os branches | git clone -b dev <url> |
| Só precisa de um branch | git clone -b dev --single-branch <url> |
| Já clonou e quer outro branch | git 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.