Çalışan bir kod yazmak yeterli değildir; o kodu altı ay sonra siz ya da bir başkası okuyup anlayabilmeli. Çünkü kod bir kez yazılır, çok kez okunur. İşte temiz kod, tam da bunu hedefleyen bir zanaattir.
Anlamlı isimlendirme
Değişken ve fonksiyon isimleri ne işe yaradıklarını anlatmalıdır. x ya da veri1 yerine toplam_fiyat ya da kullanici_listesi yazmak, kodu yorumsuz bile anlaşılır kılar. İyi isim, en iyi belgedir.
Küçük ve tek işlevli fonksiyonlar
Bir fonksiyon tek bir işi iyi yapmalıdır. Yüzlerce satırlık dev fonksiyonlar yerine, her biri net bir görevi olan küçük fonksiyonlar hem okunması hem test edilmesi kolaydır.
Yorum ve belgeleme
Yorumlar “ne yaptığını” değil, “neden yaptığını” açıklamalıdır; çünkü ne yaptığını zaten iyi yazılmış kod gösterir. Gereksiz yorum kadar, eksik yorum da zararlıdır. Dengeyi bulmak önemlidir.
PEP 8 ve tutarlılık
Python’un resmi stil rehberi PEP 8, girinti, boşluk ve isimlendirme için ortak kurallar sunar. Bir ekip ya da topluluk aynı stili kullandığında, herkes birbirinin kodunu kolayca okuyabilir. Kavram için kodlama kuralları sayfasına bakabilirsiniz.
İşin hocası ne yapar?
İşin hocası kodu yalnızca bilgisayar için değil, onu sonra okuyacak insan için yazar. Çünkü gerçek ustalık, çalışan kodda değil, anlaşılır kodadır.
İlgili yazı: Git ve Sürüm Kontrolü
Sıkça Sorulan Sorular
Temiz kod (clean code) nedir?
Yalnızca çalışan değil, aynı zamanda kolay okunan, anlaşılan ve bakımı yapılabilen koddur. Anlamlı isimler, küçük fonksiyonlar ve tutarlı bir stil temiz kodun temelidir.
Değişken isimlendirmesi neden önemlidir?
Çünkü anlamlı isimler kodu yorum olmadan bile anlaşılır kılar. “x” yerine “toplam_fiyat” gibi açıklayıcı isimler kodu okuyan herkesin işini kolaylaştırır.
PEP 8 nedir?
Python’un resmi stil rehberidir. Girinti, boşluk ve isimlendirme gibi konularda ortak kurallar sunar; böylece farklı geliştiricilerin kodu tutarlı ve okunur olur.