Início·Comandos de terminal

git worktree

git

Uso

git worktree add <path> [<branch>]

Cria uma segunda pasta de trabalho do mesmo repositório para tocar dois branches ao mesmo tempo sem clonar de novo; o mesmo branch não pode estar em duas, e apagar a pasta na mão deixa um registro até o prune.

Opções comuns

OpçãoSignificado
add <path> <branch>check that branch out into another folder
add -b <new> <path>create a branch and check it out there
listshow every working tree of this repository
remove <path>delete a working tree cleanly
pruneforget trees whose folder you deleted by hand
--detachcheck out a commit without a branch

Exemplos

git worktree add ../hotfix hotfix/login

a second folder on another branch, sharing one .git

git worktree add -b release ../rel main

creates release from main in ../rel

git worktree remove ../hotfix

removes the folder and its bookkeeping entry

O confuso é que desfazer tem várias formas: mover para onde um branch aponta não é o mesmo que criar um commit que reverte.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que git worktree faz?

Cria uma segunda pasta de trabalho do mesmo repositório para tocar dois branches ao mesmo tempo sem clonar de novo; o mesmo branch não pode estar em duas, e apagar a pasta na mão deixa um registro até o prune.

Q. Como se digita?

git worktree add <path> [<branch>] — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 6; a lista completa está em man git. Este comando fica em git.

Comandos relacionados

página man: man git-worktree