top of page

Python'da Yorum Satırları: Kodunuzu Anlaşılır Kılmak



Hands-on Mentor Kapsamlı Blog İçeriği
Hands-on Mentor Tutorials



Yorum Satırları Nedir?

Yorum satırları, kodun okunabilirliğini artırmak, kodun ne yaptığını açıklamak ve daha sonra kodu inceleyecek kişiler (veya kendiniz) için notlar bırakmak için kullanılan satırlardır. Python'da yorum satırları # karakteri ile başlar. Yorum satırları, programın çalışmasını etkilemez ve derlenmez.


Tek Satırlık Yorumlar

Tek satırlık yorumlar, # karakteri ile başlar ve aynı satırda yer alır. Bu tür yorumlar, genellikle kısa açıklamalar veya hatırlatmalar için kullanılır.


Örnek:

# Bu bir tek satırlık yorumdur
print("Merhaba, Dünya!")  # Bu da bir yorumdur


Çok Satırlı Yorumlar

Çok satırlı yorumlar, birden fazla satırı kapsar ve genellikle uzun açıklamalar veya dokümantasyon için kullanılır. Python'da çok satırlı yorumlar için geleneksel olarak üçlü tırnak (''' veya """) kullanılır, ancak bu genellikle bir string olarak değerlendirilir. Yine de, bu yöntem genellikle çok satırlı yorumlar için kullanılır.


Örnek:

"""
Bu bir çok satırlı yorumdur.
Birden fazla satırı kapsar.
Genellikle uzun açıklamalar için kullanılır.
"""
print("Merhaba, Dünya!")


Python Yorumların Kullanım Alanları

  1. Kodun Açıklanması: Kodun ne yaptığını açıklamak için kullanılır.

  2. Geçici Değişiklikler: Geçici olarak kodun bir kısmını devre dışı bırakmak için kullanılır.

  3. Hataları Belirleme: Kodda olası hataları veya dikkat edilmesi gereken noktaları belirtmek için kullanılır.

  4. Geliştirme Notları: Kodun ileride nasıl geliştirileceğine dair notlar eklemek için kullanılır.


Kod Açıklamaları

Kodun ne yaptığını açıklamak için yorumlar kullanılır. Bu, özellikle karmaşık veya anlaşılması zor kod parçaları için önemlidir.


Örnek:

# Kullanıcıdan isim alır
isim = input("Adınızı girin: ")

# Kullanıcının ismini ekrana yazdırır
print("Merhaba, " + isim)


Geçici Değişiklikler

Kodun bir kısmını geçici olarak devre dışı bırakmak için yorumlar kullanılabilir. Bu, özellikle hata ayıklama sırasında yararlıdır.


Örnek:

print("Bu kod çalışır")
# print("Bu kod çalışmaz çünkü yorum satırıdır")


Hataları Belirleme

Kodda olası hataları veya dikkat edilmesi gereken noktaları belirtmek için yorumlar kullanılabilir.


Örnek:

# Bu bölümde dikkatli olun, bölme işlemi sıfıra bölme hatası verebilir
bolunen = 10
bolen = 0
if bolen != 0:
    sonuc = bolunen / bolen
else:
    sonuc = "Tanımsız (0'a bölme)"


Geliştirme Notları

Gelecekte yapılacak değişiklikler veya geliştirmeler için notlar eklemek için yorumlar kullanılabilir.


Örnek:

# TODO: Kullanıcıdan alınan verileri doğrula
isim = input("Adınızı girin: ")
print("Merhaba, " + isim)


İyi Yorum Yazma Uygulamaları

  • Kısa ve Öz Olun: Yorumlarınızın kısa ve anlaşılır olmasına dikkat edin.

  • Güncel Tutun: Yorumlarınızı, kodunuzla birlikte güncel tutun.

  • Kodun Ne Yaptığını Açıklayın, Nasıl Yaptığını Değil: Kodun nasıl çalıştığını değil, ne yaptığını açıklamaya çalışın.

  • Tutarlı Olun: Yorum yazma stilinizde tutarlı olun.


Yorumların Gücü ve Sınırlamaları

Yorumlar, kodun okunabilirliğini ve bakımını artıran güçlü araçlardır. Ancak, aşırı yorum kullanımı da kodun karmaşık ve dağınık görünmesine neden olabilir. Yorumları dengeli ve etkili bir şekilde kullanmak önemlidir.


Sonuç

Bu blog yazısında, Python'da yorum satırlarının nasıl kullanıldığını, tek satırlık ve çok satırlı yorumların nasıl yazıldığını ve iyi yorum yazma uygulamalarını öğrendiniz. Yorumlar, kodunuzu daha anlaşılır ve sürdürülebilir kılar. Python programlarınızı yazarken ve geliştirirken yorumları etkili bir şekilde kullanarak, kodunuzu kendiniz ve diğer geliştiriciler için daha anlaşılır hale getirebilirsiniz.

 

Python temellerini atıp, veri analizi ve bilimi için yetkinlik kazanmak istiyorsanız, 1 aylık yoğun Python kampına hemen kayıt olabilirsiniz. ~40 saat canlı ders, ~50 adet kapsamlı proje, ~15 adet quiz ve sayısız kodlama egzersizinden oluşan, Finlandiya eğitim modellerinden esinlenilerek Helsinki'de geliştirilen interaktif ve pratik odaklı eğitim programına hemen göz atın !




bottom of page