Git’te Birleştirme (Merge) Çakışmaları Nasıl Çözülür Eğitimi

Birleştirme Türleri

Git merge ve rebase, hedef daldaki commit’leri kaynak dala entegre etmenin iki yoludur. Ayrıca Git merge, hızlı-ileri alma (fast-forward) veya hızlı-ileri almadan (no-fast-forward) birleştirme gerçekleştirebilir. Hedef dalın ucu (head) kaynak dalda mevcutsa, varsayılan olarak hızlı-ileri alma yapılır; eksikse hızlı-ileri almadan birleştirme yapılır. Git rebase ise hedef dalın commit geçmişini yeniden sıralayan başka bir birleştirme türüdür. 

Hızlı-ileri alma (fast-forward) birleştirme

Varsayılan olarak Git merge, eksik commit’leri hedef dala entegre etmek için hızlı-ileri alma kullanır. Örneğin, uzak sunucudan pull komutuyla yerel dalı güncellerken kullanılır. Hızlı-ileri alma, hedef dalın ucu kaynak dalda yoksa Git bunu uygulamayacağından, birleştirme çakışması oluşturmaz. 

Hızlı-ileri almadan (no-fast-forward) birleştirme

Hızlı-ileri almadan birleştirme, üç yönlü (three-way) veya gerçek birleştirme olarak da adlandırılır. Kaynak ve hedef daldaki değişiklikleri entegre ederek hedef dal üzerinde yeni bir commit oluşturur. Değişiklikler, her iki daldaki son ortak commit’ten sonra harmanlanır. Bizim örneğimizde bu, C’den sonradır. Bu birleştirme türü, kaynak dal hedef dal ile çelişiyorsa Git merge çakışması tetikleyecektir. Yukarıdaki diyagramda, birleştirme commit’i (X), K ve E’nin birleştirme commit’inin ebeveynleri olduğu, kaynak ve hedef dalın entegrasyonuyla oluşturulmuştur. 

Rebase 

Git rebase diğer türlerden biraz farklıdır. Hedef dalın commit geçmişinin sırasını değiştirir. Rebase, kaynak dalı öyle bir şekilde entegre eder ki hedef dal, son ortak commit’ten sonra önce kaynak dalın tüm değişikliklerini, ardından hedef dal commit’lerini içerir. Bizim örneğimizde son ortak commit C’dir; D ve E ise kaynak daldandır. K* commit’i, farklı bir commit kimliğiyle K’nın aynısıdır. C’ye bağlanmak yerine E’ye bağlanacaktır. Hızlı-ileri almadan birleştirmeye benzer biçimde, kaynak ve hedef dalda uyumluluk sorunları varsa Git, yeniden temellendirmeyi (rebase) tamamlamadan önce çakışmayı çözmeniz için uyarı verir. 

Git Birleştirme Çakışması Türleri

İki tür Git birleştirme çakışması vardır: başlangıçta ve birleştirme süreci sırasında - Atlassian. Bu bölümde her iki türü ve her senaryoda çözüm yollarını ele alacağız. 

Birleştirmenin başlangıcında

Çalışma dizininde veya hazırlama alanında (staging area) değişiklikler varsa Git merge başlangıçta başarısız olur. Gelen birleştirme commit’lerinin değişiklikleri ezmesini önlemek için başta başarısız olur. Bu, diğer dallarla veya geliştiricilerle değil, yerel değişikliklerle çakışma nedeniyle gerçekleşir. Yerel durumu stabilize etmek için git stash, git commit, git checkout veya git reset gibi komutları kullanabilirsiniz.

Birleştirme sırasında

Birleştirme sırasında bir hata, birden fazla geliştiricinin aynı dosyayı değiştirdiği ve kaynak dal ile hedef dal arasında bir çakışma olduğu anlamına gelir. Otomatik birleştirme başarısız olursa Git, sorunları el ile çözmenizi ister. Değişiklikleri görselleştirip entegre etmeye yardımcı olması için üçüncü taraf araçlar da kullanabilirsiniz.

Git Birleştirme Çakışmalarını Çözme Komutları

Bu bölümde, Git birleştirme çakışmalarını görselleştirmek ve çözmek için çeşitli yerel komutları öğreneceğiz. 

Yaygın komutlar

Git status, değiştirilmiş dosyaların, hazırlama alanının ve commit’lerin durumunu göstermek için en sık kullanılan komuttur. Birleştirme sürecinde çakışan dosyaları belirlemek için kullanılır.  

git statusAltyapı:

--merge argümanlı Git log, kaynak dal ile çakışma içindeki commit’lerin listesini üretir. 

git log --mergeAltyapı:

Varsayılan olarak git diff seçeneği, commit edilmemiş değişikliklerle önceki commit’ler arasındaki farkı gösterir. Git diff, dalları, commit’leri ve dosyaları karşılaştırmak için kullanılır. Gelecekteki birleştirme çakışmalarını önlemeye yardımcıdır. 

git diff Altyapı:

Başlangıçta başarısız olan birleştirme için komutlar

Checkout, değişiklikleri geri almak veya yeni ya da eski bir dala geçmek için kullanılır. 

git checkoutAltyapı:

Git reset, çalışma dizinindeki ve hazırlama alanındaki değişiklikleri geri almaya yarar. 

git reset --mixedAltyapı:

Birleştirme sırasında çakışmalar için komutlar

--abort argümanı birleştirme sürecini durdurur ve değişiklikleri birleştirme başlamadan önceki orijinal durumuna döndürür. 

git merge --abortAltyapı:

Git reset genellikle birleştirme sırasında, çakışan dosyaları özgün durumlarına döndürmek için kullanılır.

git resetAltyapı:

Silinmiş-değiştirilmiş dosya çakışmalarını çözme

Geçerli dalda bir dosyayı silip başka bir dalda birinin o dosyayı değiştirmesi durumunda Git çakışması oluşur. Bu durumda ya dosyayı ekleyip commit edebilirsiniz,

git add <filename>Altyapı:

ya da dosyayı kaldırıp commit edebilirsiniz. 

git rm <filename>Altyapı:

📌 Git birleştirme çakışması çözüm kılavuzu (cheat sheet)

Görsel Birleştirme Araçları

Birleştirme araçları, her tür çakışmayı tanımlayıp çözmek için kullanıcı dostu görsel araçlardır. Bazı araçlar, değişiklikleri karşılaştırma, Git işlemleri ve proje/depo yönetimi gibi ek yetenekler de sunar. İki tür Git birleştirme aracı vardır: yalnızca terminal ve GUI tabanlı. Terminal tabanlı araçlar PowerShell veya Bash içinde açılır, GUI tabanlı araçlar pencereli bir ortamda açılır. 

Yüklü ve geçerli araçların listesini kontrol etmek için şunu kullanın:

git mergetool --tool-help Altyapı:

Liste, git komutlarıyla kurulup entegre edilebilen tüm geçerli araçlardan oluşur.

Örneğin, varsayılan olarak vim ve nvim yüklüdür; commit edilmemiş bir dosya ile önceki bir commit arasındaki farkı görmek istiyorsanız şunu yazın:

git difftool --tool=vimdiff3Altyapı:

vimdiff3 aracı değişiklikleri vurgular ve commit’leri terminal içinde karşılaştırmanıza olanak tanır. 

vimdiff3’te aynı dosyanın iki sürümü arasındaki fark

Meld

Meld, birleştirme çakışmalarını çözmeyi bir üst seviyeye taşıyan, ücretsiz ve açık kaynaklı bir araçtır. Git ile entegre etmek için önce resmi siteden indirip kurulumu yapmanız gerekir. Ardından küresel yapılandırmaya ekleyin; böylece Git, varsayılan olarak çakışmaları çözmek için Meld’i başlatacaktır.  

Aşağıdaki yapılandırma komutları yalnızca Windows kullanıcıları için geçerlidir. Mac veya Linux için yapmanız gereken tek değişiklik, kurulu Meld dosyasının yolunu değiştirmektir. 

git config --global merge.tool meld 

git config --global mergetool.meld.path "C:/Program Files (x86)/Meld/Meld.exe" 

git config --global diff.tool meld

git config --global difftool.meld.path "C:/Program Files (x86)/Meld/Meld.exe"Altyapı:

Varsayılanları ayarladıktan sonra, Git yerel dizini içinde git difftool yazarak Windows sürümü Meld’i başlatabilir veya aşağıda gösterildiği gibi çakışmaları çözmek için git mergetool kullanabilirsiniz.

Meld ile birleştirme çakışmasını çözme

VSCode

VSCode, birleştirme çakışmalarını çözmek için en iyi ve en popüler yöntemlerden birini sunar. Git dosyaları otomatik olarak birleştirmeyi başaramadığında VSCode çakışan kodu vurgular ve size dört seçenek sunar: mevcut değişiklikleri kabul et (accept current), gelen değişiklikleri kabul et (accept incoming), her ikisini kabul et ve değişiklikleri karşılaştır. Bu seçenekleri kullanarak dosyanızı temizleyebilir ve bekleyen tüm sorunları çözebilirsiniz. 

VSCode ile birleştirme çakışmasını çözme

Git işlemleriniz için eksiksiz bir çözüm arıyorsanız GitKraken’i deneyin. Ücretsiz bir istemci, VSCode uzantısı ile gelir ve birleştirme çakışmalarını çözmek için yerleşik bir araç sunar.  

Git Birleştirme Çakışması Nasıl Çözülür

Bu bölümde, bir Git birleştirme çakışmasını nasıl oluşturacağımızı ve sonra nasıl çözeceğimizi öğreneceğiz. Eğitim iki kısımdan oluşuyor. İlk kısımda Git çakışmalarını yerelde çözmeyi öğreneceğiz; ikinci kısımda uzak sunucuyla (GitHub) çakışmaları çözmeyi ele alacağız.

Yerel birleştirme çakışması

Birleştirme çakışmaları oluşturmak, bu sorunların ilk etapta nasıl ortaya çıktığını öğrenmemize yardımcı olur. Böylece bu problemleri yaratıcı yollarla çözebilir veya gelecekte oluşmalarını engelleyebiliriz. 

Şimdi tek dosyalı bir Git deposu oluşturup başlamak için ilk commit’imizi yapacağız. 

1. datacamp adlı bir klasör oluşturun.
2. Dizini datacamp’e değiştirin.
3. Git’i başlatın.
4. README.md dosyasını verilen başlıkla oluşturun.
5. Dosyadaki değişiklikleri hazırlayıp commit edin.

mkdir datacamp
cd datacamp
git init
echo "# How to Resolve Git Merge Conflict" > README.md
git add README.md
git commit -m "first commit"

>>> [main (root-commit) 8199ea2] first commit
>>>  1 file changed, 1 insertion(+)
>>> create mode 100644 README.mdAltyapı:

Sonra readme adlı yeni bir dal oluşturacak ve başlığı “..Git Merge..” ifadesinden “..Git..” ifadesine çevireceğiz. Dosyayı ekleyin ve -am argümanını kullanarak commit oluşturun.

git checkout -b readme
echo "# How to Resolve Git Conflict" > README.md
git commit -am "new branch conflict added"

>>> [readme 155f694] new branch conflict added
>>> 1 file changed, 1 insertion(+), 1 deletion(-)Altyapı:

Ana dala geri dönün ve README.md dosyasına >> kullanarak yeni bir satır ekleyin. Değişiklikleri kaydedip commit oluşturarak aynı dosyanın iki sürümü arasında başarıyla bir çakışma oluşturmuş olduk. 

git checkout main
echo "New change in base branch" >> README.md
git commit -am " a line added to base branch Readme file"

>>> [main f1f1874]  a line added to base branch Readme file
>>> 1 file changed, 1 insertion(+)Altyapı:

Görüldüğü gibi readme dalını birleştirirken Git, otomatik birleştirmenin başarısız olduğunu ve sonucu commit etmeden önce değişiklikleri el ile yapmamız gerektiğini belirten bir mesaj gösterdi. 

git merge readme

>>> Auto-merging README.md
>>> CONFLICT (content): Merge conflict in README.md
>>> Automatic merge failed; fix conflicts and then commit the result.Altyapı:

Notepad’de dosyayı açıp düzenleyerek sorunu el ile çözeceğiz. Aşağıdaki görselde HEAD ile gösterilen ok, bir ayırıcı ve farklı yönde okla readme görünüyor. HEAD bölümü ana daldaki mevcut değişiklikleri, readme bölümü ise birleştirmek istediğimiz ve farklı bir başlık içeren dalı gösterir. 

Birleştirme çakışmasını el ile çözme 

Problemi çözmek için readme dalına ait kısmı, okları ve ayırıcıyı kaldıracağız. Dosyanın son hali aşağıda gösterildiği gibi temiz görünmelidir. 

Çakışma çözüldü 

Dosyayı ekleyip commit ettikten sonra birleştirme çakışması çözülecektir. Bu, sorunları çözmenin en yaygın ve en basit yoludur. Sorunları daha hızlı çözmek için tümleşik geliştirme ortamı (IDE) da kullanabilirsiniz.

git commit -am "conflict resolved in file README.md"
>>> [main 9994a29] conflict resolved in file README.mdAltyapı:

Uzak depo birleştirme çakışması

Uzak birleştirme çakışmaları oluşturup çözmek için GitHub’da yeni bir depo oluşturmamız gerekiyor.

GitHub’da yeni depo oluşturma

Ardından uzak adı (origin) ile adresi depoya ekleyin ve yerel depodaki tüm değişiklikleri upstream kullanarak uzak main dalına push edin.

git remote add origin https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
git push --set-upstream origin main


>>> Enumerating objects: 12, done.
>>> Counting objects: 100% (12/12), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (12/12), 998 bytes | 499.00 KiB/s, done.
>>> Total 12 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), done.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  * [new branch]      main -> main
>>> branch 'main' set up to track 'origin/main'.Altyapı:

Bir çakışma oluşturmak için uzak ve yerel README.md dosyasında değişiklik yapmamız gerekir. GitHub dosya düzenleyicisini kullanarak “..Git merge..” ifadesini “..Sit-Merge..” olarak değiştirebilir ve ardından değişiklikleri commit edebilirsiniz. 

GitHub düzenleyicide değişiklik yapma

Ardından yerel depoda, README.md dosyasını yalnızca basit bir başlık ekleyecek şekilde değiştirin ve değişiklikleri commit edin. 

echo "# How to Resolve Merge Conflicts in Git Tutorial" > README.md
git commit -am "local branch changes in README.md"

>>> [main c677a13] local branch changes in README.md
>>>  1 file changed, 1 insertion(+), 4 deletions(-)Altyapı:

Son olarak değişiklikleri uzak sunucuya push edin. Git’in, sorunu nasıl gidereceğinize dair ipuçlarıyla birlikte bir hata verdiğine dikkat edin. 

git push


>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  ! [rejected]        main -> main (fetch first)
>>> error: failed to push some refs to 'https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git'
>>> hint: Updates were rejected because the remote contains work that you do
>>> hint: not have locally. This is usually caused by another repository pushing
>>> hint: to the same ref. You may want to first integrate the remote changes
>>> hint: (e.g., 'git pull ...') before pushing again.
>>> hint: See the 'Note about fast-forwards' in 'git push --help' for details.Altyapı:

En basit ipucunu izleyeceğiz: push etmeden önce dosyayı uzak sunucudan pull etmek. 

README.md dosyasında birleştirme çakışması nedeniyle pull işlemi başarısız oldu. Bunu Notepad ile el ile düzeltebilirdik; ancak bu kez bize yardımcı olması için görsel bir araç kullanacağız. 

git pull


>>> remote: Enumerating objects: 5, done.
>>> remote: Counting objects: 100% (5/5), done.
>>> remote: Compressing objects: 100% (2/2), done.
>>> remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
>>> Unpacking objects: 100% (3/3), 681 bytes | 75.00 KiB/s, done.
>>> From https://github.com/kingabzpro/DataCamp-Git-Merge-Guide
>>>    aaf149d..49b7d14  main       -> origin/main
>>> Auto-merging README.md
>>> CONFLICT (content): Merge conflict in README.md
>>> Automatic merge failed; fix conflicts and then commit the result.Altyapı:

Birleştirme aracı Meld, çakışan dosyaları belirleyecek ve bunları Meld GUI uygulamasında gösterecektir.   

git mergetool

>>> Merging:
>>> README.md

>>> Normal merge conflict for 'README.md':
>>>   {local}: modified file
>>>   {remote}: modified fileAltyapı:

Üç sütun vardır: README_LOCAL_473.md, README.md ve README_LOCAL_473.md. Uzak değişikliklerin geçerli olduğunu düşünüyorsanız uzak sütundaki siyah oka; yerel değişikliklerin kalmasını istiyorsanız yerel sütundaki siyah oka tıklayın. Bu kadar basit. 

Birleştirme aracı Meld kullanılarak çakışma çözüldü

Değişiklikleri yaptıktan sonra dosyayı kaydedip commit edin. Görüldüğü gibi, dosyayı uzak sunucuya push etmek birleştirme çakışması hatası üretmiyor.

git commit -am "remote main branch conflict resolved"
git push

>>> Enumerating objects: 16, done.
>>> Counting objects: 100% (16/16), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (10/10), 1.08 KiB | 550.00 KiB/s, done.
>>> Total 10 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), completed with 1 local object.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>    49b7d14..8f5c3aa  main -> mainAltyapı:

Hem yerel hem de uzak birleştirme çakışmalarını başarıyla çözdük. Bu çakışmalarla veri bilimciler ve makine öğrenimi mühendisleri günlük olarak karşılaşır. Git işlemlerindeki becerilerinizi geliştirmek için Introduction to Git kursunu alın. 

Sonuç

Git birleştirme çakışmalarını çözmek, hatalı kodu birleştirerek yazılımı bozabileceğiniz için karmaşık ve oldukça riskli bir görevdir. Birleştirme araçları, çakışmaları tespit edip çözmek için daha güvenli, kullanıcı dostu bir ortam sağlar. Bu eğitimde Git çakışmalarının neden oluştuğunu ve nasıl çözüleceğini öğrendik. Ayrıca çeşitli birleştirme ve çakışma türlerini, yararlı Git komutlarını ve görsel araçları ele aldık. Son bölümde ise yerel ve uzak depoda bir çakışma oluşturup çözdük. 

Git’te yeniyseniz ve nasıl çalıştığını öğrenmek istiyorsanız şunu okuyun: Intro to Git and GitHub Tutorial.