Git Commit Eğitimi: Kod Değişikliklerini Nasıl İzler ve Belgeleriz

Git, kod tabanlarındaki değişiklikleri yönetmek için başvurulan sistem haline geldi. Git’teki en kritik komutlardan biri, projenizin tarihçesinin belirli bir andaki anlık görüntüsünü yakalayan git commit komutudur.

git commit komutunu verimli kullanmayı anlamak, temiz ve düzenli bir proje geçmişi sürdürmek için çok önemlidir. Anlamlı commit mesajları yazmak ve en iyi uygulamalara uymak, tek başınıza ya da daha büyük bir ekibin parçası olarak çalışıyor olun, deponuzun yönetilebilir kalmasını sağlar. 

Bu eğitim, git commit komutunu nasıl kullanacağınızı, net ve bilgilendirici commit mesajları yazmayı ve başarılı sürüm kontrolü için en iyi uygulamaları benimsemeyi öğretmeyi amaçlar.

Haydi başlayalım!

Git Commit Nedir?

Sürüm kontrolünün en temel yapı taşlarından biri Git'te git commit komutudur. Bir git commit, aşamaya alınmış dosyalarınızın mevcut durumunun anlık görüntüsünü yakalar ve bunları deponun tarihçesine kaydeder. Yapılan değişikliklere benzersiz bir tanımlayıcı oluşturur ve yazar, zaman damgası ve açıklayıcı commit mesajı gibi temel meta verileri kaydeder—bu sayede değişiklikler gerektiğinde izlenebilir, anlaşılabilir ve geri alınabilir. 

Geliştiriciler ayrıca yapılan değişiklikleri kısaca açıklayan ve güncellemenin bağlamını ve gerekçesini sunan bir commit mesajı da ekleyebilir.

Özetle commit’ler önemlidir çünkü geliştiricilerin şunları yapmasını sağlar:

• Değişiklikleri izlemek: Commit’ler zaman içinde kod tabanında yapılan değişikliklerin net bir kaydını sunar.
• İşbirliği yapmak: Ekip ortamında, commit’ler hangi değişikliklerin kim tarafından ve neden yapıldığını anlamaya yardımcı olur.
• Önceki durumlara dönmek: Bir hata veya sorun ortaya çıktığında, commit’ler projeyi sorunlu değişiklikten önceki kararlı bir noktaya geri almayı sağlar.
• Temiz bir geçmiş sürdürmek: Anlamlı mesajlara sahip yapılandırılmış, sık commit’ler büyük projeleri yönetmeyi ve sorunları teşhis etmeyi kolaylaştırır.

> Git ve GitHub’a yeni başlıyorsanız, GitHub Foundations öğrenme yolu sürüm kontrolü ve işbirliği iş akışlarının temelini ustalıkla öğrenmeniz için özenle hazırlanmış bir rota sunar.

Git Commit’in Temel Sözdizimi

Git’i etkili kullanmak için commit’lerin temel sözdizimini ve yapısını anlamalısınız. Bu bölüm, değişikliklerin doğru şekilde yakalanması ve belgelenmesi için commit sürecinin çekirdek bileşenlerini ele alır.

Temel komut

Bir commit oluşturmanın en basit yolu aşağıdaki komutu kullanmaktır: 

git commit -m “Your commit message” Altyapı:

Burada -m bayrağı, değişiklikleri açıklayan kısa bir commit mesajı eklemenizi sağlar. Bu alan, gelecekte başvuru ve işbirliği için bağlam sağladığınız yerdir; örneğin: 

git commit -m “Fix bug in user authentication” Altyapı:

Bu komut commit’i hazırlar ve verilen mesajla ilişkilendirir. 

Bir commit sırasında neler olur

Commit yaptığınızda perde arkasında olanlar şöyledir: 

1. Değişiklikleri sahneleme: Commit’ten önce git add komutunu kullanarak değişiklikleri sahnelemeniz gerekir. Bu, değiştirilmiş dosyaları bir sonraki commit’e dahil edilmek üzere hazırlar. Tek tek dosyaları veya tüm değişmiş dosyaları sahneleyebilirsiniz. 

git add file.txt  #Stages one file
git add .  #Stages all files in the current directoryAltyapı:

2. Commit’i oluşturma: Değişiklikleriniz sahnelendikten sonra, git commit komutu bu sahnelenmiş dosyaların anlık görüntüsünü alır ve depoya kaydeder. Anlık görüntünün, o anda dosyaların mevcut durumu olduğunu unutmayın.
3. Depoyu güncelleme: Commit’ten sonra Git, projeye ait geçmişi günceller ve commit’i önceki tüm commit’lerin yanına kaydeder. Her commit, gerektiğinde geri dönülebilecek bir kontrol noktası görevi görür.

Etkili Git Commit Mesajları Yazma

Açık ve anlamlı commit mesajları yazmak, temiz ve anlaşılır bir proje geçmişi sürdürmek için gereklidir. İyi yazılmış bir commit mesajı aynı zamanda bir iletişim aracıdır; geliştiricilerin ve işbirlikçilerin her değişikliğin amacını ve bağlamını hızla kavramasına yardımcı olur.

İyi commit mesajlarının önemi

İyi commit mesajları bir harita gibi işlev görür. Her değişikliğin arkasındaki muhakemeye ışık tutar; bu da daha sonra kod gözden geçirilirken veya sorun giderilirken paha biçilmez hale gelir. İyi yazılmış commit mesajları, hataları izlemeyi, özelliklerin evrimini anlamayı ve deponun geçmişinde gezinmeyi de kolaylaştırır. 

Commit mesajları için en iyi uygulamalar

Commit mesajlarınızın amacına hizmet etmesini sağlamak için şu en iyi uygulamaları izleyin:

1. Açıklayıcı olun: Bir commit mesajı, neyin değiştiğini ve gerekliyse neden yapıldığını açıklamalıdır. "fix" veya "update" gibi muğlak ya da genel mesajlardan kaçının. Bunun yerine belirginliği hedefleyin. Örneğin, “Giriş formu doğrulama hatasını düzelt” ifadesi, sadece “Hata düzeltme” demekten çok daha faydalıdır.
2. Geniş zaman kullanın: Commit mesajları geniş zamanda yazılmalıdır. Bu, sanki commit'in o anda yaptığını anlatıyormuşsunuz izlenimi verir. Örneğin, "Giriş doğrulamasını ekle" ifadesini, "Giriş doğrulamasını ekledim" yerine kullanın.
3. Kısa ve sade tutun: Öz bir mesaj daha okunabilirdir. Özet (commit mesajının ilk satırı) genellikle 50–72 karakter olmalıdır; daha fazla açıklama gerekiyorsa, sonraki satırlarda daha uzun bir açıklama ekleyebilirsiniz. Bu yaklaşım, mesajın çeşitli Git araçları ve arayüzleriyle kolayca görüntülenmesini sağlar.
4. Ayrıntılı değişiklikler için madde işaretleri kullanın: Commit’iniz birden çok ilişkili değişiklik içeriyorsa, genişletilmiş açıklamada madde işaretleri kullanarak nelerin yapıldığını bölün. Bu, net bir yapı oluşturarak takibi kolaylaştırır.

> Commit’lerin temelinin ötesine geçmek istiyorsanız, Intermediate Git kursu amend, rebase ve ekiplerde commit geçmişini yönetme gibi daha gelişmiş kavramları adım adım ele alır.

Gelişmiş Git Commit Seçenekleri

-m bayrağı, git commit komutlarında yaygın kullanılan bir seçenektir ve günlük kullanım için yeterlidir. Ancak, değişiklikleri yönetirken daha fazla esneklik ve verimlilik sağlayan başka gelişmiş seçenekler de vardır. Bu bölümde bu seçeneklere göz atacağız. 

Sahnelemeden commit etme

Birçok durumda, commit etmeden önce dosyaları git add ile elle sahnelemek gereksiz gelebilir; özellikle de tüm değiştirilmiş dosyaların commit edilmesi gerektiğinde. Bu süreci hızlandırmak için Git, tüm izlenen dosyaları sahneleyip tek adımda commit eden -a bayrağını sunar. Yani daha önce izlenen dosyalarda yapılan değişiklikler, git add komutunu ayrıca çalıştırmadan commit’e dahil edilir.

Çalışma şekli şöyledir:

git commit -a -m “Your commit message” Altyapı:

Bir commit’i amend etmek

Hatalar olabilir. Bazen az önce yaptığınız bir commit’i değiştirmeniz gerekir. --amend seçeneği, yeni bir commit oluşturmak yerine en son commit’i değiştirmenizi sağlar. Böylece commit mesajını güncelleyebilir veya aynı commit’e ek dosyalar ekleyebilirsiniz.

Örneğin, son commit’in mesajını düzeltmek için: 

git commit --amend -m "Update commit message"Altyapı:

Ya da bir dosyayı sahnelemeyi unuttuysanız, önce dosyayı ekleyin, ardından commit’i amend edin:

git add missed-file.txt
git commit --amendAltyapı:

Bu işlem, önceki commit’i etkin biçimde güncellenmiş olanla değiştirir. 

Amend işleminin, başkalarıyla paylaşılmamış commit’lerde (ör. paylaşılan bir depoya itilmemiş) yapılması gerektiğini unutmayın; aksi halde başkalarının bağlı olabileceği tarihçeyi yeniden yazmış olursunuz!

Belirli bir commit’ten değişiklik ve dosyalarla commit etme

Bazen, ilgisiz değişiklikler yapmadan, önceki bir commit’teki bir sorunu düzeltmeniz gerekir. Git, daha önceki bir commit’e özel olarak bağlı bir takip commit’i oluşturmaya yardımcı olan --fixup seçeneğini sunar. Bu, değişikliklerinizi birleştirmeden önce commit geçmişinizi temizlemeniz gerektiğinde özellikle kullanışlıdır.

Örneğin, belirli bir commit için fixup oluşturmak üzere:

git commit --fixup <commit-hash>Altyapı:

Bu komut, belirtilen commit’teki sorunları gidermeyi amaçlayan yeni bir commit oluşturur. 

Daha sonra etkileşimli rebase yaptığınızda, Git bu fixup commit’lerini referans verdikleri özgün commit ile otomatik olarak birleştirebilir.

> Commit’leri birleştirmek (squash) gibi daha gelişmiş iş akışları için, ayrıntılı anlatımımızı Git Squash Commits eğitiminde takip edebilirsiniz.

Git ile Commit’leri Yönetme

Projeniz geliştikçe ve commit geçmişi büyüdükçe, commit’leri yönetmek düzenli ve gezinilebilir bir depo sürdürmenin kritik bir yönü haline gelir. Etkili commit yönetimi, hata ayıklamaya, işbirliğine ve temiz, anlaşılır bir geçmiş tutmaya yardımcı olur. 

Git, commit geçmişini görüntülemenizi ve gerektiğinde değişiklikleri revize etmenizi veya hatta geri almanızı sağlayan güçlü araçlar sunar. Bu commit’leri nasıl yöneteceğinizi bilmek, sorunları çözerken veya proje geçmişinizi iyileştirirken önemli ölçüde zaman kazandırabilir.

Commit geçmişini görüntüleme

Commit yönetiminin önemli bir yönü, projenin geçmişini anlamaktır. git log komutu, commit’lerinizin ayrıntılı bir geçmişini görüntülemenizi sağlar. Bağlam olarak, değişikliklerin ne zaman, kim tarafından yapıldığını ve hangi mesajların eklendiğini gösterir.

Örneğin, temel git log komutu şöyledir:

git logAltyapı:

Bu, commit hash’lerini, yazar adlarını, tarihleri ve commit mesajlarını görüntüler. 

Ancak Git, günlük çıktısını belirli ihtiyaçlara göre özelleştirmenize de olanak tanır. Örneğin, görüntülenen commit sayısını şu şekilde sınırlayabilirsiniz: 

git log -n 5 # shows the last 5 commitsAltyapı:

Her commit’te yapılan değişiklikleri incelemek için, her commit’in diff’ini gösteren -p bayrağını kullanın. 

Görünümü şu şekildedir:

git log -pAltyapı:

Bir commit’i geri alma veya tersine çevirme

Bazen geri adım atmanız veya değişiklikleri geri almanız gerekir. Güvenli bir geri alma yolu, git revert komutunu kullanmaktır. Bu komut, commit geçmişini değiştirmeden, önceki bir commit’in getirdiği değişiklikleri geri alan yeni bir commit oluşturur. 

Bu, commit’leri başkalarıyla zaten paylaştığınızda ve geçmişi olduğu gibi korumak istediğinizde özellikle faydalıdır.

Bir commit’i geri almak için şunu kullanın:

git revert <commit-hash>Altyapı:

Bu komut, belirtilen commit’in değişikliklerinin tersini uygular ve onları şeffaf bir geçmişi koruyarak etkin biçimde geri alır.

Bir commit’i resetleme

Bazı durumlarda, bir veya daha fazla commit’i silerek deponuzu tamamen önceki bir duruma döndürmek isteyebilirsiniz. git reset komutu bunu yapmanızı sağlar. Ancak bir commit’i resetlemek commit geçmişini değiştirir; bu nedenle özellikle değişiklikler zaten paylaşılan bir depoya itilmişse dikkatli kullanılmalıdır.

Git reset üç mod sunar:

1. Soft reset: Commit işaretçisini belirtilen bir commit’e geri taşır ancak değişiklikleri çalışma dizininde ve sahneleme alanında tutar. Değişikliklerinizi koruyarak commit’i yeniden yapmak istediğinizde kullanışlıdır. 

git reset --soft <commit-hash>Altyapı:

2. Mixed reset: Commit işaretçisini belirtilen bir commit’e geri taşır ve değişiklikleri çalışma dizininde tutar, ancak sahneleme alanını temizler. Bu, Git’in varsayılan reset modudur.

git reset --mixed <commit-hash>Altyapı:

3. Hard reset: Commit işaretçisini belirtilen bir commit’e geri taşır ve hem çalışma dizinindeki hem de sahneleme alanındaki tüm değişiklikleri atar. Esasen deponuzu seçilen commit’in durumuna döndürür ve commit’ten sonra yapılan tüm değişiklikleri siler. 

git reset --hard <commit-hash>Altyapı:

git reset komutu güçlü bir araçtır; ancak sonuçlarını (özellikle işbirlikçi bir ortamda çalışırken) anlamak çok önemlidir.  

Git’te Commit Etme İçin En İyi Uygulamalar

Etkili sürüm kontrolü, yalnızca Git komutlarını bilmeyi değil—aynı zamanda temiz, anlaşılır ve verimli bir proje geçmişi sürdürmek için belirli en iyi uygulamaları izlemeyi de gerektirir. Bu uygulamalar yalnızca kendi çalışmalarınızı yönetmenize yardımcı olmakla kalmaz, aynı zamanda işbirlikçilerin katkıda bulunmasını ve değişiklikleri gözden geçirmesini de kolaylaştırır.

Sık commit edin, ama küçük tutun

İyi bir kural, erken ve sık commit etmek ancak her commit’i küçük ve odaklı tutmaktır. Bu yaklaşım, her commit’in ayrı ve mantıklı bir iş birimini temsil etmesini sağlar. 

Sık commit etmek, büyük değişiklikleri yönetilebilir parçalara bölmeye yardımcı olur; bu da gözden geçirmeyi, test etmeyi ve projenizin evrimini izlemeyi kolaylaştırır. Daha küçük ve izole değişiklikleri commit ederek karmaşık hatalar oluşturma riskini de azaltırsınız. Bir şeyler ters giderse, commit’ler daha ayrıntılı olduğunda sorunu izole etmek ve düzeltmek daha kolaydır.

Yalnızca ilgili değişiklikleri commit edin

Her commit tek bir görev veya sorun üzerine odaklanmalıdır. İlgisiz değişiklikleri tek bir commit’te karıştırmak, gözden geçirmeyi ve değişikliklerin arkasındaki niyeti anlamayı zorlaştırır. Gerekirse belirli değişiklikleri geri almak veya cherry-pick yapmak sürecini de karmaşıklaştırır.

Örneğin, bir özellik üzerinde çalışırken kodun başka bir yerinde küçük bir hata fark ederseniz, bunları iki ayrı commit olarak ele almak daha iyidir. Bu, neyin neden yapıldığının net anlaşılmasını sağlar—ayrıca her commit’in anlamlı ve izole kalmasını temin eder.

Commit geçmişi üzerinde başkalarıyla işbirliği yapın

Ekip halinde çalışırken, commit’lerin nasıl ele alındığı ve sunulduğu konusunda işbirlikçilerinizle uyum sağlamak esastır. Buna, commit mesajları için tutarlı bir format üzerinde anlaşmak ve herkesin en iyi uygulamaları takip ettiğinden emin olmak dahildir. pre-commit gibi Git kancaları, commit mesajı biçimleri gibi kuralları zorlamaya veya commit’e izin verilmeden önce testleri çalıştırmaya yardımcı olabilir.

İşbirliği, commit’leri yönetmeye ve gözden geçirmeye yardımcı olan araçlarla da güçlenir; örneğin platformlar olan GitHub veya GitLab. Açık ve iyi belgelenmiş bir commit geçmişi, ekip üyelerinin değişiklikleri anlamasını, iyileştirmeleri tartışmasını ve projenin verimli biçimde ilerlemesini kolaylaştırır.

> Commit etmeden önce artık dosyaları temizlemek ister misiniz? git clean komutunu nasıl kullanacağınızı izlenmeyen dosyaları kaldırma eğitiminde öğrenin.

Yaygın Git Commit Sorunlarını Giderme

Git commit’leri bazen hatalara veya iş akışınızı yavaşlatabilecek zorluklara yol açabilir. Bu yaygın sorunları nasıl gidereceğinizi anlamak, sorunsuz bir sürüm kontrolü sürdürmek ve ileride daha büyük problemlerden kaçınmak için kritik önemdedir.

Commit mesajı hataları

Commit ederken yapılan yaygın hatalardan biri commit mesajı eklemeyi unutmak veya yanlışlıkla muğlak ya da boş bir mesaj kullanmaktır. Net ve bilgilendirici commit mesajları, değişiklikleri takip etmek ve işbirlikçilerin bir projenin tarihçesini anlamasını sağlamak için gereklidir. Git genellikle mesaj olmadan commit etmenizi engeller, ancak yine de mesajın kalitesini gözden kaçırmak mümkündür.

Çözüm: Enter’a basmadan önce commit mesajınızı her zaman iki kez kontrol edin. Yanlışlıkla boş veya belirsiz bir mesajla commit gönderirseniz, en son commit mesajını değiştirmek için git commit --amend komutunu kullanarak düzeltebilirsiniz. 

Commit’ten sonra ortaya çıkan çakışmalar

Aynı projede birden fazla kişi çalıştığında çakışmalar kaçınılmazdır. Genellikle, dalları birleştirirken veya rebase yaparken, commit’ten sonra ortaya çıkarlar. Git iki commit arasındaki farkları otomatik olarak çözemediğinde bir çakışma oluşur ve hangi değişikliklerin korunacağına manuel olarak karar vermeniz gerekir.

Çakışmalar en çok iki veya daha fazla katkıda bulunan aynı kod bölümünü değiştirdiğinde ya da projede büyük yeniden düzenlemeler yapıldığında görülür. Göz korkutucu olabilseler de, Git bu çakışmaları veri kaybetmeden çözmek için gereken araçları sağlar.

Çözüm: Bir çakışma meydana geldiğinde, Git dosyalarda çakışan bölümleri işaretler ve dosyayı düzenleyerek istenen değişiklikleri yansıtacak şekilde bunları manuel olarak çözmeniz gerekir. Gerekli değişiklikleri yaptıktan sonra dosyayı git add ile sahneleyin, ardından çözülen değişiklikleri commit ederek merge veya rebase işlemini tamamlayın. Git’in birleştirme çakışması düzenleyicisi veya harici birleştirme araçları da çakışmaları daha verimli çözmenize yardımcı olabilir.

Sonuç

git commit komutu, Git’te sürüm kontrolünün temel bir yönüdür ve geliştiricilerin çalışmalarının zaman içinde izlenebilen, gözden geçirilebilen ve yeniden ziyaret edilebilen anlık görüntülerini oluşturmasını sağlar. Commit’ler, bir projedeki değişikliklerin ne olduğu, neden gerekli oldukları ve ne zaman uygulandıkları konusunda netlik sağlayan kilometre taşlarıdır.

Bu eğitimde, git add ile dosyaları sahnelemekten git commit ile commit’i sonlandırmaya kadar commit oluşturmanın temel sözdizimini ve sürecini ele aldık. Açıklayıcı, öz commit mesajları yazmanın önemini; mesajları tanımlayıcı tutmak, geniş zaman kullanmak ve kısalığı korumak gibi en iyi uygulamaları tartıştık. 

Ayrıca, sahnelemeden commit etme ve commit’leri amend etme gibi gelişmiş seçenekleri inceleyerek değişikliklerinizi yönetirken esneklik sunduk. git log, geri alma ve resetleme gibi komutlarla commit’lerin nasıl yönetileceğine de baktık.

GitHub’ı daha derinlemesine keşfetmeye hazır mısınız? GitHub Concepts kursumuz, fork’lar, dallar, issue’lar ve işbirliği en iyi uygulamalarına değinir. Gerçek bir iş akışına ya da mülakata hazırlanıyorsanız, Complete Git Cheat Sheet elinizin altında bulundurmanız için harika bir başvuru kaynağıdır!