İçeriğe geç
parazade
Yazılım & No-Code

Yorum Satırı Nedir?

İngilizce: Code Comment

Yayın: · Son güncelleme:

Yorum Satırı Nedir? Kısaca

Yorum satırı (code comment), kaynak kodun içine yazılan ama derleyici ya da yorumlayıcı tarafından çalıştırılmayan açıklama metnidir. Kodun neden öyle yazıldığını anlatmak ya da geçici olarak bir satırı devre dışı bırakmak için kullanılır.

Yorum Satırı nedir?
İçindekiler
  1. Yorum satırı nedir?
  2. Dillere göre yazımı
  3. İyi yorum nasıl yazılır?

Yorum satırı nedir?

Yorum satırı, kodu okuyan insanlar için bırakılan nottur. Program bu satırları görmezden gelir, yalnızca programcılar okur. Örneğin # KDV oranı 2026 başında güncellendi gibi bir not, üç ay sonra kodu açan kişiye o sayının neden değiştiğini anlatır.

Kodda yorum satırı ne demek sorusunun bir diğer cevabı da "geçici olarak kapatılmış kod"dur. Bir satırın başına yorum işareti koymak, onu silmeden devre dışı bırakır.

Dillere göre yazımı

Dil Tek satır Çok satır
Python # not Üç tırnaklı metin bloğu
JavaScript, Java, C // not /* not */
HTML Yok <!-- not -->
SQL -- not /* not */

Çoğu kod editöründe Ctrl+/ kısayolu seçili satırları yorum hâline getirir ya da yorumu kaldırır. Bu kısayol, kodun bir bölümünü hızlıca denemek için sık kullanılır.

İyi yorum nasıl yazılır?

İyi yorum "ne" yapıldığını değil, "neden" yapıldığını anlatır. sayac += 1 # sayacı bir artır yorumu bir şey katmaz, çünkü kod bunu zaten söyler. Buna karşılık # Banka API'si 3 denemeden sonra hesabı kilitliyor, bu yüzden sınır 2 yorumu, koddan çıkarılamayacak bir bilgiyi verir.

Yorumların kodla birlikte güncellenmesi de gerekir. Kod değişip yorum eski kalırsa, okuyanı yanlış yönlendirir. Yorumla kapatılmış eski kod bloklarını uzun süre bırakmak yerine silin; sürüm kontrol sistemi onları zaten saklar.

Sıkça Sorulan Sorular

Yorum satırları programı yavaşlatır mı?

Hayır. Derlenen dillerde yorumlar derleme sırasında tamamen atılır, yorumlanan dillerde de okuma aşamasında atlanır. Çalışma hızına etkileri yok denecek kadar azdır.

Yorum satırı ile dokümantasyon aynı şey mi?

Yorumlar kodun içindeki kısa notlardır. Dokümantasyon ise yazılımın nasıl kullanılacağını anlatan daha kapsamlı belgelerdir; bazı araçlar özel biçimli yorumlardan otomatik dokümantasyon üretir.

İlgili terimler

Temiz Kod(Clean Code)Temiz kod (clean code), başka bir geliştiricinin kolayca okuyup anlayabileceği, değiştirebileceği ve test edebileceği biçimde yazılmış koddur. Anlamlı isimler, küçük ve tek işe odaklı fonksiyonlar ve gereksiz karmaşıklıktan uzak bir yapı temel özellikleridir.Yazılım Dokümantasyonu(Software Documentation)Yazılım dokümantasyonu, bir yazılımın nasıl kurulduğunu, kullanıldığını, nasıl çalıştığını ve geliştirildiğini anlatan kullanıcı kılavuzu, teknik belge, API referansı ve kod açıklamaları gibi yazılı materyallerin tamamıdır.Kaynak Kod(Source Code)Kaynak kod, bir programın programcılar tarafından okunabilir bir programlama diliyle yazılmış asıl metnidir. Bu metin derleyici ya da yorumlayıcıyla bilgisayarın çalıştırabileceği biçime dönüştürülür.READMEREADME, bir yazılım projesinin kök klasöründe bulunan ve projenin ne işe yaradığını, nasıl kurulup çalıştırılacağını ve nasıl katkı verileceğini anlatan, genellikle Markdown biçiminde yazılmış tanıtım dosyasıdır.PythonPython, okunabilir ve sade sözdizimiyle bilinen, genel amaçlı, açık kaynaklı bir programlama dilidir. Veri bilimi, yapay zekâ, otomasyon ve web geliştirmede en yaygın kullanılan dillerden biridir.SQLSQL (Structured Query Language, yapılandırılmış sorgu dili), ilişkisel veritabanlarındaki verileri sorgulamak, eklemek, güncellemek, silmek ve tabloları yönetmek için kullanılan standart bir dildir.Karşılık(Provision)Karşılık, muhasebede gerçekleşmesi muhtemel ama tutarı veya zamanı kesin olmayan bir yükümlülük ya da varlık değer kaybı için önceden ayrılan ve dönemin giderine yansıtılan tahmini tutardır.Sürüm Kontrol Sistemi(Version Control System)Sürüm kontrol sistemi (version control system), dosyalarda yapılan her değişikliği kim, ne zaman ve neden yaptığıyla birlikte kaydeden ve gerektiğinde eski sürümlere dönmeyi sağlayan yazılımdır. En yaygın örneği Git'tir.

İlgili yazılar

Yapay Zeka ile Kazanç

Kendi Bilgisayarında Ücretsiz Yapay Zekâ Sistemi Kur: Ekran Kartı, İşlemci ve RAM ile Adım Adım

Kendi bilgisayarında ücretsiz ve limitsiz bir yapay zekâ sistemi kurmak mümkün: Ollama ya da LM Studio ile dil modeli, Continue ile kod asistanı, ComfyUI ya da Forge ile görsel üretim. Belirleyici olan ekran kartının belleğidir (VRAM); 8 GB'lık kartta 7-8B modeller rahat çalışır, kart yoksa işlemci ve RAM ile daha yavaş çalışır.

· 30 dk okuma