O que é worktree
Worktree é um diretório de trabalho adicional ligado ao mesmo repositório. Ele permite abrir outra branch sem interromper o que já está aberto no diretório principal.
O histórico e os objetos são compartilhados. O worktree cria apenas o diretório e o registro da branch usada ali.
O isolamento das branches
Cada branch fica em um worktree por vez. A separação evita duas alterações concorrentes no mesmo estado e deixa claro qual diretório pertence a cada tarefa.
O diretório adicional pode ficar em outra pasta, com o mesmo repositório. O comando de listagem mostra os worktrees ativos e a branch de cada um.
O uso na rotina
A correção urgente cabe em um worktree próprio. A tarefa em andamento continua aberta, e a correção não mistura arquivos com o trabalho atual.
A revisão de duas branches também ganha. Os dois diretórios podem ser abertos no editor, e a comparação fica lado a lado.
Exemplo
Como conferir
Liste os worktrees e a branch de cada um. Confira o diretório e o estado do trabalho, e remova o diretório que não está mais em uso.
O Git mantém o histórico compartilhado, e o commit registra a alteração. O merge continua sendo a forma de integrar a correção à branch principal.
Dúvidas frequentes
Perguntas frequentes sobre Worktree
- Worktree é a mesma coisa que clonar o repositório?
- Não. O clone cria outro repositório. O worktree cria um diretório ligado ao mesmo repositório e compartilha o histórico e os objetos.
- Posso ter a mesma branch em dois worktrees?
- Não. Cada branch fica em um worktree por vez, para evitar duas alterações concorrentes no mesmo estado.
- Para que serve na rotina?
- Para corrigir uma falha urgente enquanto a tarefa atual continua aberta. Também serve para comparar duas branches lado a lado.
- Como remover um worktree?
- O comando de remoção apaga o diretório e o registro. A branch continua no repositório, e o trabalho não confirmado precisa ser tratado antes.
Para continuar
Recursos relacionados
Documentação
Git: documentação do worktree
Descreve a criação, a listagem e a remoção de diretórios de trabalho.
Abrir recursoSite de referência
Wikipedia: Git
Apresenta o modelo de repositório e de ramificação do Git.
Abrir recursoAplicação na formação
Developer Workspace
No Developer Workspace, o worktree aparece na comparação entre branches e na correção urgente sem interromper a tarefa atual.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.