Seleção de branches e commits
No Git, o checkout seleciona uma branch ou um commit e atualiza o estado usado no diretório de trabalho. O comando git checkout também restaura arquivos específicos. Os argumentos determinam se ele troca a referência selecionada ou substitui o conteúdo de um caminho.
Ao trocar para uma branch, o Git posiciona HEAD, a referência do estado atual, nessa branch. Ao selecionar diretamente um commit, ele pode deixar HEAD destacado, apontando para o commit sem acompanhar uma branch.
Troca de branch e restauração de um caminho
O exemplo abaixo seleciona a branch local ajuste-menu, que precisa existir no repositório:
git checkout ajuste-menuO comando troca para essa branch. Alterações locais compatíveis podem permanecer no diretório de trabalho, mas o Git recusa a troca comum quando ela sobrescreveria edições não registradas. Você pode consultar git status para conferir a branch e as alterações locais.
A inclusão de um caminho muda a função do comando. O exemplo seguinte usa um arquivo README.md já rastreado:
git checkout -- README.mdNesse caso, o Git restaura o arquivo a partir do índice, a área que reúne o conteúdo preparado para o próximo commit. As edições do arquivo que ainda não estão no índice são descartadas. O separador -- identifica o argumento seguinte como caminho.
Com uma revisão explícita, como em git checkout HEAD -- README.md, a origem é o commit atual. Esse modo atualiza tanto o arquivo quanto o índice e pode substituir conteúdo que já estava preparado. Confira a origem e o caminho ao interpretar uma instrução de restauração.
Dúvidas frequentes
Perguntas frequentes sobre checkout
- O checkout cria uma cópia de outro repositório?
- O checkout seleciona uma branch ou um estado no repositório local. Para obter outro repositório, o comando correspondente é git clone.
- O que significa HEAD destacado?
- Nesse modo, HEAD aponta diretamente para um commit. Novos commits podem ser criados ali, mas você precisa associá-los a uma branch para continuar o trabalho por ela.
- Quais comandos separam as funções do checkout?
- O git switch é voltado à troca de branches. O git restore restaura arquivos e permite escolher se a alteração afeta o diretório de trabalho, o índice ou ambos.
Para continuar
Recursos relacionados
Documentação
Git: seleção de branches, revisões e arquivos
Manual do git checkout com os modos de troca de branch, seleção de commit e restauração de caminhos.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Para conferir uma troca de branch ou uma restauração de arquivo no seu repositório, o Desenvolvimento Colaborativo oferece orientação ao vivo com você no terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de alterações feitas por agentes exige conferir a branch selecionada e preservar as edições locais durante a troca de versão.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.