Git “Your branch is ahead of ‘origin/main’” mesajı, yerel dalında uzak depoya henüz gönderilmemiş bir commit bulunduğunu gösterir. Örneğin “by 1 commit” ifadesi, yerel dalının karşılaştırılan uzak izleme dalından bir commit ileride olduğunu anlatır.
Bu durum tek başına bir hata değildir. Değişiklikleri commit etmek onları Git’in yerel geçmişine kaydeder, uzak depoya göndermek için ayrıca git push komutunu çalıştırman gerekir.
Bu mesaj yerel dalda gönderilmemiş commit olduğunu söyler
git status çıktısında aşağıdaki satırı gördüğünü düşünelim:
On branch main
Your branch is ahead of 'origin/main' by 1 commit.
(use "git push" to publish your local commits)
nothing to commit, working tree clean
Buradaki mesaj, main adlı yerel dalında bulunan bir commit’in origin/main tarafından henüz bilinmediğini söyler. Git’in güncel belgelerinde dalın, bağlı olduğu üst dal ile karşılaştırılması ve ileride ya da geride olan commit sayısının gösterilmesi bu şekilde açıklanır. Daha ayrıntılı terminoloji için Git status belgelerine bakabilirsin.
Commit’i, yaptığın değişikliklerin Git geçmişine kaydedilmiş bir çalışma noktası gibi düşünebilirsin. Örneğin README dosyasına bir açıklama ekleyip şu komutları çalıştırdığında değişiklik önce hazırlanır, ardından yerel geçmişe kaydedilir:
git add README.md
git commit -m "README dosyasını güncelle"
Bu işlemin sonunda commit yerel depoda bulunur. Bilgisayarındaki proje klasöründe yer alan main dalı yerel daldır. Uzak depo, projenin sunucuda bulunan ortak kopyasıdır. origin/main ise Git’in uzak deponun main dalı hakkında yerel olarak tuttuğu karşılaştırma kaydıdır.
Bu nedenle commit atmak ile dosyaları uzak depoya göndermek aynı işlem değildir. git commit, değişiklikleri yerel geçmişe kaydeder. git push ise yerel commitleri uzak depoya aktarır. Push işleminden sonra Git, uzak izleme dalını da yeni duruma göre güncellediğinde “ahead” mesajı genellikle ortadan kalkar.
origin/main ve uzak depo arasındaki ilişki nasıl işler?

origin, çoğu klonlanmış depoda uzak depo için kullanılan yerel takma addır. main, izlenen dalın adıdır. Bu iki ad birlikte kullanıldığında origin/main, uzak deponun main dalına ait remote tracking branch, yani uzak izleme dalı anlamına gelir.
Uzak depodaki son bilgileri yerel Git kayıtlarına almak için git fetch origin komutunu kullanabilirsin:
git fetch origin
Bu komut uzak depodaki branch bilgilerini ve gerekli commit nesnelerini indirerek yerel uzak izleme dallarını günceller. Çalışma dalındaki dosyaları doğrudan değiştirmez ve yerel dosyalarına otomatik olarak merge uygulamaz. Bu yüzden git fetch sonrasında değişiklikleri inceleyebilir, ardından hangi işlemi yapacağına karar verebilirsin.
Fetch yapılmadan çalışıldığında origin/main bilgisi eski kalabilir. Böyle bir durumda Git’in karşılaştırdığı uzak izleme dalı, uzak depodaki gerçek son durumdan geride olabilir. Bu nedenle “ahead” mesajını değerlendirirken uzak bilgilerinin ne zaman güncellendiğini de dikkate almak gerekir.
Git status çıktısında yerel dalın ileride ve geride olduğu aynı anda görülebilir. Bu, yerel dalında henüz gönderilmemiş commitler bulunduğunu ve uzak izleme dalında yerel dalında olmayan başka commitler görüldüğünü ifade eder. Böyle bir durum yalnızca “yerel commitleri gönder” şeklinde okunmamalıdır; iki tarafın geçmişi birlikte değerlendirilmelidir.
Bazı depolarda ana dalın adı main yerine master olabilir. Bu durumda karşılaştırma origin/master üzerinden yapılır ve komutlarda gerçek dal adı kullanılır. Uzak dalın adını git branch -r veya git status çıktısıyla kontrol edebilirsin. Uzak ve yerel dal aynı noktadaysa status çıktısında şu ifade görülebilir:
Your branch is up to date with 'origin/main'.
Gönderilmemiş commitleri nasıl görür ve push edersin?

Gönderilmemiş commitleri görmek için git log origin/main..HEAD komutunu, uzak depoya aktarmak için ise git push origin main komutunu kullanabilirsin. origin/main, uzak depodaki main dalının bilgisayarındaki uzak izleme kaydıdır. Bu kayıt güncel değilse Git karşılaştırmayı eski bir bilgi üzerinden yapar.
Aşağıdaki akışta önce uzak izleme kaydı yenileniyor, ardından README.md dosyası değiştirilip commit oluşturuluyor ve uzak depoya gönderiliyor:
$ git fetch origin
$ echo "Git çalışma notları" >> README.md
$ git add README.md
$ git commit -m "README dosyasını güncelle"
[main 5d6e7f8] README dosyasını güncelle
1 file changed, 1 insertion(+)
$ git status
On branch main
Your branch is ahead of 'origin/main' by 1 commit.
(use "git push" to publish your local commits)
nothing to commit, working tree clean
$ git log origin/main..HEAD --oneline
5d6e7f8 README dosyasını güncelle
$ git push origin main
To github.com:ornek/proje.git
1a2b3c4..5d6e7f8 main -> main
$ git status
On branch main
Your branch is up to date with 'origin/main'.
nothing to commit, working tree clean
Commit sonrasındaki ahead of 'origin/main' by 1 commit mesajı, yerel main dalında uzak izleme dalında bulunmayan bir commit olduğunu gösterir. git log origin/main..HEAD --oneline komutu da origin/main içinde bulunmayan ve mevcut HEAD konumuna kadar gelen commitleri kısa biçimde listeler.
git push origin main komutu bu committeki değişiklikleri uzak depodaki main dalına gönderir. Push sonrasında görülen up to date ifadesi, yerel dal ile karşılaştırılan origin/main kaydının aynı commit noktasını gösterdiğini anlatır. git fetch origin komutunu uzun süre çalıştırmadıysan, push öncesindeki durum mesajının uzak deponun gerçek son hâli yerine bilgisayarındaki eski karşılaştırma kaydına dayanabileceğini unutma. Ana dalın adı bazı depolarda master olabilir. Böyle bir durumda komutlarda main yerine master yazılır.
Yanlış commit gönderilmediyse nasıl güvenle geri alırsın?
Henüz uzak depoya gönderilmemiş son commit için hangi değişiklikleri korumak istediğine göre farklı reset seçenekleri kullanabilirsin. Commiti kaldırıp dosyalardaki değişiklikleri yeniden düzenlemek istiyorsan, git reset --soft HEAD~1 komutu commit noktasını bir önceki commit'e taşır ve değişiklikleri hazırlama alanında tutar.
git reset HEAD~1 komutunda varsayılan davranış mixed reset'tir. Bu işlem commit'i kaldırır, hazırlama alanını bir önceki commit ile eşleştirir ve dosyalardaki değişiklikleri çalışma alanında bırakır. Böylece değişiklikleri inceleyip yeniden git add ile hazırlayabilirsin.
Değişikliklerin de atılması isteniyorsa git reset --hard HEAD~1 kullanılabilir. Bu komut HEAD'i, hazırlama alanını ve takip edilen dosyaların çalışma alanındaki hâlini hedef commit ile eşleştirir. Bu nedenle hem yerel commit hem de henüz kaydedilmemiş dosya değişiklikleri kaybolabilir.
git reset --hard origin/main daha geniş bir geri dönüş yapar. Yerel dalı bilgisayarındaki origin/main kaydıyla hizalamaya çalışırken gönderilmemiş yerel commitleri ve takip edilen dosyalardaki kaydedilmemiş değişiklikleri silebilir. Komutun etkisini anlamadan çalıştırmak yerine şu soruları sırayla yanıtla:
- Commit kalsın mı? Yeniden düzenlemek istiyorsan
--softveya varsayılanmixedseçeneğini değerlendir. - Dosya değişiklikleri korunsun mu? Korunacaksa
--hardkullanma. - Uzak izleme dalına dönmek gerçekten gerekli mi? Gerekli değilse
origin/mainhedefli reset yerine commit geçmişini yeniden düzenleyen daha kontrollü seçeneği kullan.
Git durumunu kontrol ederken hangi hatalardan kaçınmalısın?
Git durumunu anlamanın güvenli yolu, yerel dosyaları, yerel commitleri ve uzak depo bilgisini ayrı ayrı kontrol etmektir. git status çalışma alanını ve izleme bilgisini gösterir. Uzak depodaki son durumu öğrenmek için önce git fetch origin çalıştırmak gerekir; çünkü git status karşılaştırmayı yerel uzak izleme dalındaki bilgiye göre yapar.
- Önce çalışma alanını kontrol et. README gibi bir dosyada kaydedilmemiş değişiklik varsa önce bunları incele.
git statusçıktısındaki “Changes to be committed”, “Changes not staged for commit” ve “Untracked files” bölümleri birbirinden farklı durumları gösterir. - Uzak bilgiyi güncelle. Başka bir bilgisayardan veya ekip arkadaşından yeni commit gelmiş olabileceğini düşünüyorsan
git fetch originkomutunu çalıştır. Bu işlem yerel dosyalarını birleştirmez, uzak izleme dalının bildiği commit noktasını günceller. - Gönderilmemiş commitleri incele. Ana dalın adı
mainise şu komutla yerelde bulunuporigin/mainiçinde bulunmayan commitleri görebilirsin:
git log origin/main..HEAD
Bu liste beklediğin commitleri gösteriyorsa ve gönderme kararın netse git push kullan. Commit oluşturmak, değişikliklerin yerel Git geçmişine kaydedilmesidir. git push ise bu commitleri ve gerekli nesneleri uzak depoya göndererek uzak dalın güncellenmesini sağlar.
- “Up to date” mesajını bağlamıyla değerlendir.
Your branch is up to date with 'origin/main'.ifadesi, yerel dalın bildiği uzak izleme dalıyla aynı noktada olduğunu söyler. Fetch yapmadan bu mesajı uzak deponun kesin ve anlık durumu olarak yorumlama. - Geri alma komutunun hedefini iki kez kontrol et.
git reset --hard origin/mainyerel dalı uzak izleme dalının gösterdiği noktaya taşıyabilir.git reset --hard HEAD~1ise mevcut dalın son commitinden bir önceki noktaya döner. Her iki komut da yerel commitleri dalın erişiminden çıkarabilir ve kaydedilmemiş değişikliklerin üzerine yazabilir. Bu nedenle öncegit statusvegit logçıktısını incele.
origin/main her depoda kullanılacak sabit bir ad değildir. Bazı depolarda ana dal master olabilir veya mevcut dal başka bir uzak izleme dalını takip edebilir. Böyle bir durumda komutları origin/master ya da git status çıktısında görünen ilgili adla uyarlamalısın.
Sık Sorulan Sorular
Commit atınca dosyalar uzak depoya gönderilmiş olur mu?
Commit atınca dosyaların bir anlık görüntüsü yerel Git geçmişine kaydedilir; uzak depoya gönderim için ayrıca git push çalıştırman gerekir.
Ahead ve behind aynı anda görünüyorsa ne anlama gelir?
Yerel dalında uzak depoya gönderilmemiş commitler, uzak izleme dalında ise yereline alınmamış farklı commitler bulunduğu anlamına gelir. Bu iki geçmişi incelemeden doğrudan reset veya zorla gönderim komutu kullanma.
git reset --hard origin/main neden risklidir?
Bu komut mevcut dalı origin/main tarafından gösterilen commit noktasına taşırken yerel commitlerini dalın dışına çıkarabilir ve kaydedilmemiş dosya değişikliklerinin üzerine yazabilir. Hedefin gerçekten doğru dal olduğundan emin olmadan çalıştırılmamalıdır.
origin/main yerine origin/master ne zaman kullanılmalıdır?
Mevcut deponun ana dalı master ise veya dalın uzak izleme bilgisi origin/master olarak ayarlanmışsa bu ad kullanılmalıdır. Komutlardaki dal adını depo yapılandırmasına göre belirlemek gerekir.
Önce durumu gör, ardından uzak bilgiyi güncelle, commitleri incele ve gönderme ya da geri alma kararını bundan sonra ver. Bu sıra, terminalde yanlış dalı veya yanlış commit noktasını hedefleme riskini azaltır.