Yazılım dünyasında sıkça duyulan bir söz vardır: "Kod, makineler tarafından çalıştırılmak için yazılır; ancak insanlar tarafından okunup geliştirilmek içindir." Bir projenin başarısı, sadece o an düzgün çalışmasıyla değil, aylar sonra o koda bakan başka bir geliştiricinin (veya bizzat sizin) ne kadar sürede yapıyı anlayabildiğiyle ölçülür.İşte Buna "Temiz Kod (Clean Code)" deriz.

1. Anlamlı İsimlendirme

Kodun içindeki değişkenler, fonksiyonlar ve sınıflar kendi kendilerini açıklayabilmelidir. d, data, islem gibi belirsiz isimler yerine, ne amaca hizmet ettiklerini belirten isimler seçilmelidir.

• Kötü Örnek: int d = 86400; // bir gündeki saniye

• Temiz Örnek: int seconds_per_day = 86400; İsimlendirme yaparken telaffuz edilebilir ve aranabilir kelimeler seçmek, hata ayıklama sürecini %50 hızlandırır.

2. Fonksiyonlar Tek Bir İş Yapmalı

Bir fonksiyonun içinde hem veritabanına kayıt yapıp, hem e-posta gönderip, hem de veriyi formatlıyorsanız o kod "kirli"dir. İdeal bir fonksiyon:

• Küçük olmalı.

• Sadece bir tek işi mükemmel yapmalı.

• Yan etkisi (side effect) olmamalı; yani beklemediğiniz bir değişkeni gizlice değiştirmemeli.

3. Kendini Tekrar Etme

Aynı kod bloğunu iki farklı yerde kopyalayıp yapıştırıyorsanız, orada bir tasarım hatası vardır. Tekrarlanan kod, bakım maliyetini iki katına çıkarır. Bir mantık değiştiğinde her iki yeri de güncellemek zorunda kalırsınız ve bu durum kaçınılmaz olarak "gözden kaçan" hatalara yol açar.

4. Yorum Satırlarına Güvenmeyin

Yorum satırları genellikle "kötü yazılmış kodu telafi etme" çabasıdır. Eğer bir kod bloğunu açıklamak için paragraf dolusu yorum yazmanız gerekiyorsa, o kodu daha basit parçalara bölmeyi düşünmelisiniz. En iyi yorum satırı, hiç ihtiyaç duyulmayan, kodun kendisinin anlattığı yapıdır.

Not: Sadece "neden" yapıldığını açıklayan stratejik yorumlar değerlidir; "nasıl" yapıldığını zaten kod söylemelidir.

5. Hata Yönetimi

Hata yönetimi bir yan iş değil, kodun asli görevidir. Ancak try-catch blokları kodun asıl mantığını gizleyecek kadar karmaşık olmamalıdır. Temiz kodda, hata fırlatmak (throwing exceptions) boş (null) dönmekten daha sağlıklıdır; çünkü programın nerede patladığını net bir şekilde görmenizi sağlar.

6. Boyut ve Biçimlendirme

Kodun görsel düzeni, ekibin disiplinini yansıtır. Girintilerin (indentation) düzensiz olduğu, dosyaların binlerce satır sürdüğü bir projede mantık hatalarını gizlemek çok kolaydır. Standart bir stil rehberine (Linter araçları gibi) sadık kalmak, kodun profesyonel ve güvenilir görünmesini sağlar.

Sonuç

Kirli kod yazmak, gelecekteki zamanınızdan faizle borç almaktır. Bugün "hızlı bitsin" diye yazdığınız kalitesiz kod, yarın yeni bir özellik eklemenizi imkansız hale getirebilir. Temiz kod bir mükemmeliyetçilik takıntısı değil, sürdürülebilir mühendisliğin temel taşıdır.

"Kodunuzu her zaman bulduğunuzdan daha temiz bırakın."