Git Worktree Nasıl Çalışır

Bir özelliğin yarısındasınız, birkaç dosyada değişiklik var ve biri sizden main üzerindeki bir hatayı hemen düzeltmenizi istiyor. Alışılmış seçenekler zahmetli: yarım kalmış işi commit etmek ya da stash'leyip geri getirmeyi unutmamayı ummak. Git'in üçüncü bir seçeneği var: aynı depodan, başka bir branch'te ikinci bir klasör.

Bir Git projesinin iki parçası vardır. Gizli .git klasörü olan depo, her commit'i ve her branch'i saklar. working tree ise gerçekten düzenlediğiniz dosyaların bulunduğu, tek bir branch üzerinden çıkarılmış klasördür. Normalde tam olarak bir working tree vardır. git worktree komutu aynı depoya bunlardan daha fazlasını ekler. Hata düzeltmesini adım adım izleyin.

~/code/my-app $ git status --short M src/profile.ts~/code/my-app $ git worktree add ../my-app-hotfix -b hotfix mainPreparing worktree (new branch 'hotfix')HEAD is now at 2b7f1e0 Add login~/code/my-app-hotfix $ git commit -am "Fix login redirect"[hotfix 9c4d2a1] Fix login redirect 1 file changed, 1 insertion(+), 1 deletion(-)~/code/my-app $ git log --oneline -1 hotfix9c4d2a1 Fix login redirect~/code/my-app $ git worktree remove ../my-app-hotfix

Yeni klasör, kendi dosyaları ve kendi staging alanıyla kendi branch'inin eksiksiz bir kopyasıdır. Ama geçmişin kendine ait bir kopyasını almaz. İçindeki .git bir klasör değil, asıl depoyu gösteren küçük bir metin dosyasıdır. Worktree eklemenin yeniden klonlamaktan çok daha hızlı olmasının ve bir klasörde yapılan commit'in diğerinde hemen görünmesinin nedeni budur.

Tek bir kural var: Bir branch aynı anda yalnızca bir worktree'de açık olabilir. İki klasör aynı branch'te olsaydı, birindeki commit branch'i diğerinin ayağının altından kaydırır ve onun dosyaları artık branch'le uyuşmazdı. Kuralı çiğnemeyi deneyin.

~/code/my-app $  

Git düpedüz reddeder. Aynı koda gerçekten iki yerde ihtiyacınız varsa, örneğin iki build'i karşılaştırmak için, ikinci klasör için yeni bir branch açın ya da --detach seçeneğiyle commit'i branch olmadan açın.

Peki klasörler arasında tam olarak ne paylaşılır, ne her birine aittir? Her madde için bir tahminde bulunun.

İnsanları en çok şaşırtan cevap şu: Git'in yok saydığı node_modules ya da .env gibi dosyalar yeni klasörde yoktur. Her yeni worktree'de bağımlılıkları yeniden kurmanız ya da ayarları yeniden kopyalamanız gerekebilir.

İşiniz bitince git worktree remove klasörü siler. Klasörde hala değişiklik varsa Git bunu reddeder, böylece yanlışlıkla iş kaybetmezsiniz. Klasörü elle silerseniz git worktree prune, Git'in onunla ilgili hala hatırladıklarını temizler; git worktree list de bütün worktree'lerinizi gösterir.

git worktree add ../my-app-hotfix -b hotfix main
git worktree list
git worktree remove ../my-app-hotfix
git worktree prune

Worktree'ler yeni bir nedenle yeniden popüler oldu: yapay zeka kodlama agent'ları. Birçok agent aracı her göreve kendi worktree'sini ve branch'ini verir; böylece birkaç agent birbirinin dosyalarını düzenlemeden aynı anda çalışabilir, bütün commit'leri de aynı depoya düşer.

Son bir şey: Worktree bir klon değildir. Klon, bütün geçmişi kendi branch'leri olan yeni ve ayrı bir depoya kopyalar. Worktree ise zaten sahip olduğunuz depoya bağlanmış bir klasörden ibarettir.

@aykutkardas