Quando vale a pena

Você está desenvolvendo uma mudança e precisa conferir outra branch. Em vez de reaproveitar a mesma pasta, uma worktree permite abrir uma segunda área de trabalho ligada ao repositório. O exemplo abaixo cria uma branch de revisão em uma pasta vizinha.

É uma opção para quem precisa comparar comportamentos lado a lado. Não torna conflitos impossíveis: ainda é necessário revisar o que será integrado.

Experimente sem mexer no seu projeto

Execute os comandos em uma pasta de testes vazia. O nome e o e-mail usados aqui são dados fictícios, configurados somente no repositório de demonstração.

  1. A pasta exemplo-worktree permanece na branch main.
  2. A pasta exemplo-revisao abre na branch revisao.
  3. Use git status em cada pasta antes de editar ou fazer commit.
git init -b main exemplo-worktree
cd exemplo-worktree
git config user.name Exemplo
git config user.email [email protected]
git commit --allow-empty -m inicio
git worktree add -b revisao ../exemplo-revisao
git worktree list
git -C ../exemplo-revisao status --short --branch

Separe também o que fica fora do Git

Duas pastas não significam dois ambientes completos. Confira as portas dos servidores, a configuração de banco e os arquivos locais usados pelo projeto. Se os dois processos apontarem para o mesmo banco, as alterações de um ambiente podem afetar o outro.

Dependências precisam ser preparadas conforme o projeto. Copiar um arquivo de ambiente sem conferir seu destino pode levar a uma comparação enganosa: o código muda, mas o serviço externo continua sendo o mesmo.

Antes de remover a pasta de revisão

Confira git status, preserve os arquivos necessários e encerre os processos iniciados naquela pasta. Quando ela estiver limpa e o trabalho tiver sido preservado, use git worktree remove ../exemplo-revisao a partir da pasta principal.

A remoção da worktree não exige apagar a branch. Evite forçar a remoção de uma pasta com alterações que você ainda quer manter.

Mais notícias e guias de tecnologia →

Fontes e critérios