Git Config Username: Tertemiz Commit İçin Eksiksiz Rehber

Kısa Cevap: Git Kullanıcı Adınızı Nasıl Ayarlarsınız

İhtiyacınız olan iki komut şunlar:

# Set Git username globally (all repos)
git config --global user.name "Your Name"

# Set Git username for the current repo only
git config user.name "Your Name"

Global yapılandırma, belirli bir depo bunu geçersiz kılmadıkça makinenizdeki tüm depolara uygulanır.

Düz git config komutu (--global olmadan) yalnızca şu anda içinde bulunduğunuz depoyu etkiler.

Git’in bir sonraki commit’iniz için ne kullanacağını kontrol etmek üzere bu komutu çalıştırın:

git config user.name

Bu, mevcut konumunuz için etkin kullanıcı adını gösterir — ya yerel depo ayarı ya da yerel ayar yoksa global geri dönüş.

git config user.name

Bu, mevcut konumunuz için etkin kullanıcı adını gösterir — ya yerel depo ayarı ya da yerel ayar yoksa global geri dönüş.

Git Kullanıcı Adları ve Kimlik Hakkında

Git, yaptığınız her commit’e iki bilgi ekler: bir yazar adı ve bir yazar e-postası.

Bunlar doğrudan Git yapılandırmanızdaki user.name ve user.email değerlerinden gelir. git commit çalıştırdığınızda, Git mevcut değerleri alır ve bunları o commit’in meta verilerine kalıcı olarak damgalar. Ekip arkadaşlarınız bu bilgiyi git log, blame görünümleri ve pull request’lerde görür.

Git bunların hiçbirini doğrulamaz.

İsminizi “Batman”, “Linus Torvalds” ya da sadece adınız ve soyad baş harfi olarak ayarlayabilirsiniz. Gizliliğe önem veren geliştiriciler, özellikle herkese açık açık kaynak çalışmalarında, yasal adları yerine takma adlar veya kullanıcı adları kullanır. Git umursamaz; sadece söylediğinizi kaydeder.

Unutmamanız gereken tek şey, Git kullanıcı adınızın GitHub kullanıcı adınızla aynı olmadığıdır.

Git kullanıcı adınız (user.name) yerelde yapılandırdığınız şeydir. GitHub kullanıcı adınız ise hesabınızın tanıtıcısıdır; github.com/your-handle gibi URL’lerde görünen şey. Tamamen ayrı sistemlerdir ve eşleşmek zorunda değiller.

GitHub ve GitLab gibi barındırma platformları, commit’leri hesabınızla eşlemek için e-posta adresinizi kullanır. İsim sadece görüntü içindir. Commit e-postanız GitHub hesabınızdaki bir e-postayla eşleşirse, GitHub profil resminizi gösterir ve hesabınıza bağlar. user.name içinde ayarladığınız isim metin olarak görünür, ancak commit’leri size bağlayan asıl işi e-posta yapar.

Yalnızca user.name değerini değiştirmek, bundan sonra yapacağınız commit’leri etkiler. Zaten ittiğiniz eski commit’ler orijinal yazar adlarını korur.

user.name için git config Nasıl Çalışır

Git, yapılandırma ayarlarını üç farklı yerde saklar. Beklenmedik isimlerle karşılaşmamanız için şimdi bunların neler olduğuna bakacağız.

• Sistem düzeyi yapılandırma (--system) makinedeki tüm kullanıcılara uygulanır. Pratikte nadirdir ve çoğu geliştirici hiç dokunmaz.

• Global yapılandırma (--global) işletim sistemi kullanıcı hesabınıza uygulanır ve tüm depolarınızı kapsar.

• Yerel yapılandırma (--local) tek bir deponun .git/config dosyasında bulunur ve yalnızca o depoyu etkiler.

Git, hangi değerin kazanacağına karar vermek için öncelik kuralları kullanır.

Yerel ayarlar global ayarları, global ayarlar da sistem ayarlarını geçersiz kılar. user.name’i üç düzeyde de ayarlarsanız, o deponun içindeyken Git yerel değeri kullanır ve diğerlerini yok sayar.

Diyelim ki şunlara sahipsiniz:

• Sistem: user.name = "System User"

• Global: user.name = "Global User"

• Yerel (belirli bir depo içinde): user.name = "Local User"

O depo içinde commit yaptığınızda, en spesifik olan yerel olduğu için Git “Local User”’ı kullanır. O deponun dışında ise Git global yapılandırmanızdaki “Global User”’a geri döner.

Tüm yapılandırma değerlerinizi ve nereden geldiklerini görebilirsiniz:

git config --list
git config --list --show-origin

--show-origin bayrağı, her ayarın yanına dosya yolunu yazdırır. “Git neden bu ismi kullanıyor?” sorusunu böyle çözersiniz — değeri hangi yapılandırma dosyasının ayarladığını tam olarak görürsünüz.

Bu yapılandırma dosyaları öngörülebilir konumlarda bulunur: global ayarlar için ~/.gitconfig, her depo içindeki yerel ayarlar için .git/config. Sistem yapılandırması genellikle Linux ve macOS’te /etc/gitconfig altında bulunur.

git config --global user.name "Your Name" çalıştırdığınızda Git, ~/.gitconfig dosyasına yazar ve bu değer, yerelde geçersiz kılınmadıkça her depo için varsayılanınız olur.

Geçerli Git kullanıcı adınızı nasıl kontrol edersiniz

Git’in bir sonraki commit’inize hangi ismi damgalayacağını bilmeniz gerekir. Çalıştırabileceğiniz birkaç komutu göstereyim.

user.name’i görüntülemek için hızlı komutlar

Git kullanıcı adınızı gösteren komutlar şunlardır:

# Show the active user.name for the current repo (or global if outside a repo)
git config user.name

# Show specifically the global username
git config --global user.name

# Show everything and scan for user.name and user.email
git config --list

İlk komut — git config user.name — çoğu zaman ihtiyacınız olanıdır. Git’in o depoda gerçekten kullanacağı değeri gösterir. Yerel bir geçersiz kılma varsa yerel değeri görürsünüz; yoksa global geri dönüşü görürsünüz.

Tam yapılandırma listesini filtrelemek isterseniz, çıktıyı grep ile borulayın:

git config --list | grep user.name

git config --list | grep user.name

Bu, Linux ve macOS’te çalışır. Windows’ta grep yerine findstr kullanın.

Gördüklerinizi anlamak

git config user.name bir depo içinde bir değer yazdırıyorsa, o depoda commit ederken Git bunu kullanacaktır.

Ama git config --global user.name farklı bir şey gösterebilir. Yerel bir ayar varsa Git global değeri yok sayar. İnsanların kafasının karıştığı yer burasıdır. Global yapılandırmayı değiştirirler ve commit’lerin hâlâ eski ismi göstermesine şaşırırlar.

Bunu hata ayıklamak için git config --list --show-origin kullanın:

git config --list --show-origin

git config --list --show-origin

Bu, her ayarın geldiği dosya yolunu yazdırır: yerel için - gitconfig, global için ~/.gitconfig veya sistem için /etc/gitconfig. user.name için tarayın ve hangi yapılandırma dosyasının “kazandığını” tam olarak göreceksiniz.

Adım Adım: Git kullanıcı adınızı ayarlama

Çoğu geliştirici Git kullanıcı adını bir kez ayarlar ve unutur. Ancak gerektiğinde proje bazında özelleştirebilirsiniz.

Git kullanıcı adınızı global olarak ayarlama

Bu, yeni bir makinede yapacağınız bir kerelik kurulumdur.

1. Terminal’i (macOS/Linux) veya Git Bash’i (Windows) açın
2. Komutu isminizle çalıştırın:

git config --global user.name "Your Name"

3. Başarılı olduğunu doğrulayın:

git config --global user.name

Artık Git, yerelde geçersiz kılmadığınız sürece makinenizdeki her depodaki her commit için bu ismi kullanacaktır.

Buradayken e-postanızı da ayarlamalısınız:

git config --global user.email "your.email@example.com"

Commit’lerin düzgün çalışması ve GitHub veya GitLab hesabınızla eşleşmesi için her iki değerin de ayarlanması gerekir.

git config --global user.email "your.email@example.com"

Farklı projeler için farklı isimlere ihtiyacınız varsa; örneğin iş depoları için gerçek isminiz, açık kaynak için bir takma ad gibi.

Tek bir depo için global ayarı şu şekilde geçersiz kılabilirsiniz:

1. Depoya gidin:

cd /path/to/your/repo

2. Yerel kullanıcı adını ayarlayın:

git config user.name "Project-Specific Name"

3. Git’in bunu kullanacağını doğrulayın:

git config user.name

Bu değer, o deponun içindeki .git/config dosyasında saklanır ve yalnızca o depo için global user.name değerinizi geçersiz kılar. Makinenizdeki diğer depolar etkilenmez.

Gelişmiş ipucu: includeIf ile farklı klasörler için farklı kullanıcı adları

Birden fazla projede farklı kimliklerle çalışıyorsanız; örneğin ~/work/ altındaki tüm depolar iş isminizi, ~/personal/ altındakiler takma adınızı kullanıyorsa, bunu includeIf ile otomatikleştirebilirsiniz.

Bunu ~/.gitconfig dosyanıza ekleyin:

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig-work

[includeIf "gitdir:~/personal/"]
    path = ~/.gitconfig-personal

Ardından ~/.gitconfig-work gibi ayrı yapılandırma dosyaları oluşturun:

[user]
    name = "Work Name"
    email = "work@company.com"

Ve ~/.gitconfig-personal:

[user]
    name = "Personal Handle"
    email = "personal@email.com"

Git, depo nerede bulunduğuna göre doğru kimliği otomatik olarak seçer. Manuel geçiş yapmaya gerek yoktur.

Yaygın Senaryolar ve En İyi Uygulamalar

En yaygın Git kullanıcı adı durumlarını ortalık karışmadan nasıl yöneteceğiniz burada.

İş ve kişisel kimlikleri ayrı tutma

Kişisel isminizi globalde ayarlayın, ardından iş projeleri için geçersiz kılın. Böylece kişisel depolarınız varsayılan olarak tercih ettiğiniz kimliği kullanır, iş depoları ise profesyonel isminizi kullanır.

Klasöre göre kimlikleri otomatik değiştirmek için en temiz yaklaşım includeIf kullanmaktır:

# In ~/.gitconfig
[user]
    name = "Personal Name"
    email = "personal@email.com"

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig-work

Ardından iş kimliğinizle ~/.gitconfig-work oluşturun. ~/work/ altındaki her depo otomatik olarak iş ismini alır. Bunu önceki bölümde açıkladım.

Yalnızca birkaç iş projeniz varsa depo başına yerel yapılandırma da ayarlayabilirsiniz, ancak çok sayıda depoda birden fazla kimliği yönetiyorsanız includeIf daha iyi ölçeklenir.

Takma ad veya kullanıcı adı kullanmak

Git, yasal adınızı kullanıp kullanmadığınızı umursamaz.

user.name’i bir kullanıcı adına, soyad baş harfli bir ada veya gizlilik tercihlerinize uygun başka bir şeye ayarlayabilirsiniz. Bu, katkıda bulunanların bir miktar anonimlik istediği açık kaynak çalışmalarında yaygındır. Ekip arkadaşlarınızın commit’lerinizi tanımasına yardımcı olacak bir şey seçin.

Ekip veya bot kimlikleri

Otomatik commit’ler geçmişte belirgin olsun diye “CI Bot” veya “Deploy Script” gibi açıklayıcı isimler kullanmalıdır.

git config user.name "CI Bot"
git config user.email "ci@company.com"

Bu yaklaşımla, git log’u tararken veya blame notlarını incelerken otomasyonla gelen commit’ler ile geliştiricilerin commit’leri arasındaki fark bariz olur.

Barındırma platformlarında isim ve e-postayı hizalamayı unutmayın

GitHub ve GitLab, commit’leri hesabınızla eşlemek için ismi değil e-posta adresini kullanır. Commit e-postanız GitHub hesabınızdaki bir e-postayla eşleşirse, GitHub commit’i profilinize bağlar ve avatarınızı gösterir.

user.name değeri, arayüzde metin olarak — pull request’lerde, blame görünümlerinde ve commit geçmişinde — görünür. Ekip arkadaşlarınızın değişikliği kimin yaptığını bilmesi için net bir şey ayarlayın.

git config kullanıcı adı Sorunlarını Giderme

Git kullanıcı adıyla ilgili bir şey çalışmıyorsa, muhtemelen nedenini ve çözümünü burada bulacaksınız.

Git “lütfen kim olduğunuzu söyleyin” diyor veya kimliğinizi otomatik algılayamıyor

Commit yapmaya çalıştığınızda şu hatayı görebilirsiniz:

*** Please tell me who you are.

Run
  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

Bu, Git’in user.email değerinizi ayarlamadığı ve bazen user.name’in de eksik olduğu anlamına gelir. Her ikisini de globalde ayarlayarak düzeltin:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

Bundan sonra commit’ler çalışacaktır.

Commit’lerim GitHub veya GitLab’de yanlış isim gösteriyor

Git’in o depoda aslında hangi ismi kullandığını kontrol edin:

git config user.name

Yanlış bir isim gösteriyorsa, yerel bir geçersiz kılma ayarlanmış olabilir. Şu komutla düzeltin:

git config user.name "Correct Name"

Yeni commit’ler doğru ismi kullanacaktır, ancak zaten ittiğiniz eski commit’ler orijinal yazar ismini korur.

Git kullanıcı adımı güncelledim ama eski commit’ler hâlâ eski ismi gösteriyor

Commit meta verileri, commit’i oluşturduğunuzda Git geçmişine işlenir.

user.name’i değiştirmek sadece gelecekteki commit’leri etkiler. Eski commit’lerdeki yazar isimlerini değiştirmek isterseniz, git rebase --interactive veya git filter-repo ile geçmişi yeniden yazmanız gerekir. Bu ileri düzeydir, paylaşılan dallarda risklidir ve genellikle zahmete değmez.

Projeler arasında geçiş yaparken kimlikleri karıştırıyorum

Depo konumuna göre kimlikleri otomatik olarak değiştirmek için includeIf kullanın.

Bunu ~/.gitconfig dosyanıza ekleyin:

[includeIf "gitdir:~/company/"]
    path = ~/.gitconfig-company

[includeIf "gitdir:~/personal/"]
    path = ~/.gitconfig-personal

Ardından iş kimliğinizle ~/.gitconfig-company ve kişisel kimliğinizle ~/.gitconfig-personal oluşturun. Git, deponun konumuna göre doğru olanı otomatik olarak seçer — yanlış isimle commit atma derdi kalmaz.

Sonuç

Özetle, Git kullanıcı adınızı doğru ayarlamak commit geçmişinizi temiz tutar ve işbirliğini kolaylaştırır.

Her commit doğru yazar ismini gösterdiğinde, ekibiniz kimin neyi değiştirdiğini takip edebilir. Kod incelemeleri hızlanır, blame notları anlamlı olur ve proje geçmişi okunabilir kalır. Projeler büyüdükçe ve daha çok kişi katkı yaptıkça bu daha da önem kazanır.

İş ve kişisel projeler arasında geçiş yapıyorsanız ya da farklı müşteriler için farklı isimler kullanıyorsanız, her seferinde yapılandırmaları elle değiştirmeniz gerekmez. Yerel geçersiz kılmalar veya includeIf ile bir kez kurulum yapın; Git her seferinde doğru olanı seçecektir.

Temellerin ötesine geçmeye ve Git ile GitHub konusundaki tüm kafa karışıklıklarını gidermeye hazırsanız, şu DataCamp kaynakları sonraki en iyi durağınızdır:

• Orta Düzey Git
• GitHub Kavramları
• GitHub Temelleri