Git cherry-pick ile başka bir branch’te bulunan belirli bir commit’in getirdiği değişiklik, üzerinde çalıştığın branch’e uygulanır. İşlem başarılı olduğunda bu değişiklik mevcut branch’in geçmişine yeni bir commit olarak eklenir. Böylece feature branch’teki tek bir hata düzeltmesini alabilir, o branch’te bulunan diğer commitleri taşımadan çalışabilirsin.
Cherry-pick, kaynak commit’in kendisini kopyalamaz; commit’in yaptığı değişikliği mevcut branch’in durumuna uygular. Oluşan yeni commit, mevcut branch’in geçmişine ve üst commit bilgilerine bağlı olduğu için kaynak commit’ten farklı bir commit hash’ine sahip olabilir. Git belgelerinde bu işlem, mevcut commitlerin değişikliklerini uygulayıp her biri için yeni commit kaydetme yöntemi olarak açıklanır.
Git cherry-pick ne işe yarar?
Git cherry-pick, başka bir branch’te hazırlanmış belirli bir değişikliği seçerek mevcut branch’e almanı sağlar. Örneğin feature branch’inde bir hata düzeltmesi yaptığını, ancak bu branch’te henüz tamamlanmamış başka özelliklerin de bulunduğunu düşün. Hata düzeltmesini main branch’ine almak için feature branch’in tamamını beklemeden ilgili commit’i seçebilirsin.
Komut çalıştırıldığında Git, seçtiğin commit’in yaptığı değişikliği mevcut branch’in son durumuna uygulamaya çalışır. Uygulama başarılı olursa Git yeni bir commit oluşturur ve mevcut branch’in işaret ettiği nokta bu commit’e ilerler. Kaynak branch’teki sonraki commitler bu işlemle otomatik olarak alınmaz.
Cherry-pick işleminden önce çalışma alanının temiz olması gerekir. Kaydedilmemiş dosya değişiklikleri varsa bunlar seçilen commit’in değişiklikleriyle karışabilir. Bu nedenle önce hangi branch’te olduğunu ve çalışma alanında bekleyen bir değişiklik bulunup bulunmadığını kontrol etmek gerekir.
Başka bir branch’teki commit nasıl alınır?

Örnek senaryoda hata düzeltmesi feature branch’inde bulunuyor ve bu commit’in main branch’ine alınması gerekiyor. Önce kaynak branch’in geçmişini kısa biçimde görüntüleyerek alınacak commit’in hash’ini belirle:
$ git log --oneline feature
8f3c2a1 Düzelt: boş kullanıcı adı kontrolü
4d7e9ab Profil formu eklendi
1a2b3c4 Kullanıcı profili oluşturuldu
git log commit geçmişini gösterir. --oneline seçeneği her commit’i tek satırda, kısa hash ve commit mesajıyla listeler. Buradaki örnekte alınacak commit 8f3c2a1 hash’ine sahiptir.
Şimdi hedef branch’e geç ve çalışma alanını kontrol et:
$ git switch main
Switched to branch 'main'
$ git status
On branch main
nothing to commit, working tree clean
git switch main komutu mevcut çalışma alanını main branch’ine geçirir. Ardından git status çıktısı, doğru branch’te olduğunu ve kaydedilmemiş değişiklik bulunmadığını kontrol etmeye yardımcı olur. Hedef branch’i doğrulamadan cherry-pick çalıştırmak, değişikliği yanlış branch’e uygulamana neden olabilir.
Çalışma alanı temizse seçtiğin commit’i uygula:
$ git cherry-pick 8f3c2a1
[main 91ab4de] Düzelt: boş kullanıcı adı kontrolü
1 file changed, 2 insertions(+), 1 deletion(-)
İşlem tamamlandıktan sonra main branch’inin geçmişini kontrol edebilirsin:
$ git log --oneline -3
91ab4de (HEAD -> main) Düzelt: boş kullanıcı adı kontrolü
c52b771 Sipariş listesi düzenlendi
7e6d5a0 Proje başlangıcı
Bu örnekte 8f3c2a1 kaynak commit’in, 91ab4de ise main üzerinde oluşturulan yeni commit’in temsilî hash’idir. Gerçek hash’ler, depodaki commit geçmişine ve uygulanan değişikliğe göre farklı olur. git cherry-pick birden fazla commit aldığında her değişiklik için ayrı bir commit oluşturabilir.
Cherry-pick çakışması nasıl çözülür?

Cherry-pick çakışmasını çözmek için önce sorunlu dosyaları belirle, değişiklikleri düzenle ve Git’e çözümün hazır olduğunu bildir. Ardından bekleyen işlemi devam ettirebilir veya işlemden vazgeçebilirsin.
- Durumu incele.
git statuskomutunu çalıştır. Çıktıdaki çözülmemiş dosyalar, hangi dosyalar üzerinde çalışman gerektiğini gösterir. Örneğinboth modified: ayarlar.pyifadesi, ilgili dosyanın her iki tarafta da değiştirildiğini belirtir. - Çakışan içeriği düzenle. Dosyayı açıp
<<<<<<<,=======ve>>>>>>>işaretleri arasındaki değişiklikleri incele. İhtiyacına göre satırlardan birini veya uygun bir birleşimini bırak ve çakışma işaretlerini kaldır. - Çözümü işaretle. Dosyayı kaydettikten sonra
git add ayarlar.pykomutunu çalıştır. Birden fazla çakışan dosya varsa her birini düzenleyip çözüldüğünü işaretle; ardındangit statusile durumu yeniden kontrol et. - İşleme devam et. Tüm çakışmalar çözüldüğünde
git cherry-pick --continuekomutunu çalıştır. Git, bekleyen cherry-pick işlemine devam eder; varsa sıradaki commit’i uygulamaya geçer.
Örneğin dosyada aşağıdaki gibi bir çakışma varsa üst bölüm hedef branch’teki, alt bölüm ise uygulanmaya çalışılan commit’teki içeriği gösterir:
<<<<<<< HEAD
zaman_asimi = 10
=======
zaman_asimi = 20
>>>>>>> gelen commit
Projenin gereksinimi 20 değerini kullanmaksa dosyada zaman_asimi = 20 satırını bırakıp işaretleri kaldırabilirsin. Hangi değerin uygun olduğunu yalnızca çakışma işaretlerine bakarak belirleyemezsin; değişikliğin amacını ve ilgili kodu da incele.
İşlemden vazgeçmek istersen git cherry-pick --abort kullanabilirsin. Bu komut, devam eden cherry-pick dizisini iptal ederek depoyu işlemin başlangıcındaki durumuna döndürür; dizide daha önce başarıyla uygulanmış commit’ler de bu geri dönüşe dahildir.
Birden fazla commit ve commit aralığı nasıl seçilir?
Birden fazla commit’i kimliklerini komutta sırayla yazarak veya bir revizyon aralığı belirterek seçebilirsin. Ayrı ayrı verilen commit’lerde, uygulama sırasını ihtiyaç duyduğun bağımlılıklara göre belirle.
Örneğin aşağıdaki komut, temsili kimliklere sahip commit’leri verilen sırayla uygulamayı dener:
git cherry-pick a1b2c3d e4f5a6b
Komuttan önce hedef branch’te bulunduğunu kontrol et ve kimlikleri kendi depondaki commit kimlikleriyle değiştir. İkinci commit ilkindeki bir fonksiyona dayanıyorsa sıralama önemlidir; seçilen değişikliklerin hedef branch’te bulunmayan başka bağımlılıkları da olabilir.
Aralık seçiminde A..B, B commit’inden geçmişe doğru erişilebilen, fakat A commit’inden erişilemeyen commit’leri ifade eder. Bu nedenle A seçime girmez; B ise A tarafından erişilebilir değilse seçime girer.
Doğrusal bir geçmişte commit’lerin eskiden yeniye A → B → C → D şeklinde sıralandığını düşün. Bu durumda A..D aralığı B, C ve D commit’lerini seçer. Aşağıdaki komutları, harflerin deponda bu commit’lere işaret eden geçerli referanslar olduğunu varsayarak çalıştırabilirsin:
git log --oneline --reverse A..D
git cherry-pick A..D
İlk komut, seçimi uygulamadan önce eskiden yeniye incelemene yardımcı olur; ikinci komut aralıktaki değişiklikleri uygular. Geçmiş dallandığında seçim, ekranda yan yana görünen commit’lere göre değil, commit’ler arasındaki erişilebilirlik ilişkisine göre yapılır.
Kaynak bilgisi nasıl eklenir ve hangi hatalardan kaçınılır?
Cherry-pick işlemini başka kişilerin de görebileceği branch’ler arasında izlenebilir hâle getirmek için -x seçeneğini kullanabilirsin. Bu seçenek, çakışma oluşmadan tamamlanan işlemde kaynak commit’in kimliğini yeni commit mesajına ekler.
git switch release
git cherry-pick -x a1b2c3d
Oluşturulan commit mesajının sonunda buna benzer bir satır bulunur:
(cherry picked from commit a1b2c3d...)
Bu bilgi, değişikliğin hangi commit’ten alındığını izlemeyi kolaylaştırır. Özel ve yalnızca belirli kişilerin kullandığı branch’lerde ise kaynak satırının ekip açısından anlamlı olup olmadığını değerlendirmek gerekir. Çakışmalı bir işlemde bu satır otomatik olarak eklenmeyebilir.
İşleme başlamadan önce kontrol listesi
- Hedef branch’i doğrula:
git branch --show-current - Çalışma alanının durumunu kontrol et:
git status --short - Commit’in içeriğini ve mesajını incele:
git show --stat <hash> - Aynı değişikliğin hedef branch’te daha önce uygulanıp uygulanmadığını kontrol et.
- Çakışma oluşursa yeni bir cherry-pick komutu çalıştırmadan önce
git statusçıktısını oku.
Aynı değişikliği ikinci kez uygulamak boş bir cherry-pick işlemine, yeni bir çakışmaya veya Git’in işlemi durdurmasına yol açabilir. Bu nedenle yalnızca commit’in kaynak branch’te bulunması, hedef branch’e güvenle yeniden uygulanabileceği anlamına gelmez. Çakışma sonrasında hangi dosyaların beklediğini gördükten sonra çözüm yapıp uygun devam komutunu seçmelisin.
Sık Sorulan Sorular
Cherry-pick kaynak branch’teki commit’i siler mi?
Cherry-pick kaynak branch’teki commit’i silmez; mevcut commit’in değişikliklerini aktif olduğun branch üzerinde yeni bir commit olarak uygular.
Cherry-pick sırasında işlemden nasıl vazgeçilir?
Devam eden cherry-pick işlemini iptal etmek için git cherry-pick --abort komutunu çalıştırabilirsin. Bu komut, işlemi başlatmadan önceki duruma dönmeyi sağlar.
Hedef branch’i, commit hash’ini ve çalışma alanının durumunu kontrol ederek ilerlemek, cherry-pick işlemlerinde gereksiz tekrarları ve yanlış branch’e yapılan uygulamaları azaltır.