Komentar (pemrograman) - Riwayat revisi

Maintenance script: Presentation V4: sitasi, referensi, Math, Wikimedia Commons, dan atribusi

2026-08-23T14:08:11Z

Presentation V4: sitasi, referensi, Math, Wikimedia Commons, dan atribusi

@@ Baris 1: / Baris 1: @@
-Dalam [[ilmu komputer]] dan [[pemrograman]], '''komentar''' adalah anotasi, catatan, atau penjelasan yang disisipkan di dalam [[kode sumber]] suatu [[program komputer]] dengan tujuan untuk mempermudah manusia dalam membaca dan memahami kode tersebut. Komentar sepenuhnya akan diabaikan oleh [[kompilator]] maupun [[Penerjemah (komputasi)|interpreter]] saat proses penerjemahan kode menjadi [[kode mesin]], sehingga tidak akan memengaruhi jalannya eksekusi program, performa sistem, atau ukuran biner akhir dari perangkat lunak.
+Dalam [[ilmu komputer]] dan [[pemrograman]], '''komentar''' adalah anotasi, catatan, atau penjelasan yang disisipkan di dalam [[kode sumber]] suatu [[program komputer]] dengan tujuan untuk mempermudah manusia dalam membaca dan memahami kode tersebut. Komentar sepenuhnya akan diabaikan oleh [[kompilator]] maupun [[Penerjemah (komputasi)|interpreter]] saat proses penerjemahan kode menjadi [[kode mesin]], sehingga tidak akan memengaruhi jalannya eksekusi program, performa sistem, atau ukuran biner akhir dari perangkat lunak.<ref>Thomas H. Cormen. ''Introduction to Algorithms''. MIT Press. 2009. ISBN 978-0-262-03384-8.</ref>
 Penulisan komentar yang baik merupakan salah satu aspek krusial dalam rekayasa perangkat lunak untuk menjaga [[keterbacaan]] dan pemeliharaan kode (''maintainability'') dalam jangka panjang, terutama ketika program tersebut dikembangkan oleh sebuah tim pemrogram secara kolaboratif.
@@ Baris 24: / Baris 24: @@
 == Contoh penerapan ==
-Berikut adalah contoh penerapan ketiga jenis komentar tersebut di dalam bahasa pemrograman [[Python (bahasa pemrograman)|Python]]:
+    # TODO: Tambahkan validasi untuk menangani input bilangan negatif
 == Komentar kepala dan aspek hukum ==
@@ Baris 35: / Baris 57: @@
 == Risiko keamanan ==
-Meskipun komentar sangat membantu manusia, keberadaannya di dalam kode sumber dapat menimbulkan risiko [[keamanan informasi]] yang serius jika tidak dikelola dengan bijak. Kerentanan ini terdaftar resmi dalam kamus kelemahan umum sebagai **CWE-615** (''Inclusion of Sensitive Information in Source Code Comments'').
+Meskipun komentar sangat membantu manusia, keberadaannya di dalam kode sumber dapat menimbulkan risiko [[keamanan informasi]] yang serius jika tidak dikelola dengan bijak. Kerentanan ini terdaftar resmi dalam kamus kelemahan umum sebagai **CWE-615** (''Inclusion of Sensitive Information in Source Code Comments'').<ref>[https://cwe.mitre.org/data/definitions/615.html CWE-615: Inclusion of Sensitive Information in Source Code Comments]. MITRE Corporation.</ref>
 Beberapa kesalahan fatal yang sering dilakukan oleh pemrogram meliputi:
@@ Baris 44: / Baris 66: @@
 Tabel di bawah ini menunjukkan variasi tanda sintaksis penulisan komentar pada beberapa bahasa pemrograman dan penanda teks populer:
 == Praktik terbaik ==
@@ Baris 59: / Baris 109: @@
 == Referensi ==
+<references />
 == Sumber dan atribusi ==
 Konten artikel ini diadaptasi dari [https://id.wikipedia.org/w/index.php?title=Komentar+%28pemrograman%29&oldid=29547938 Wikipedia bahasa Indonesia], revisi 29547938 (2026-08-10T01:17:49Z), yang tersedia berdasarkan lisensi Creative Commons Atribusi-BerbagiSerupa (CC BY-SA). Mohon gunakan konten ini secara bijak serta sesuai dengan ketentuan lisensi yang berlaku.

Maintenance script: Impor teks terkontrol dari Wikipedia bahasa Indonesia; revisi 29547938; atribusi sumber disertakan.

2026-08-23T13:48:04Z

Impor teks terkontrol dari Wikipedia bahasa Indonesia; revisi 29547938; atribusi sumber disertakan.

Halaman baru

Dalam [[ilmu komputer]] dan [[pemrograman]], '''komentar''' adalah anotasi, catatan, atau penjelasan yang disisipkan di dalam [[kode sumber]] suatu [[program komputer]] dengan tujuan untuk mempermudah manusia dalam membaca dan memahami kode tersebut. Komentar sepenuhnya akan diabaikan oleh [[kompilator]] maupun [[Penerjemah (komputasi)|interpreter]] saat proses penerjemahan kode menjadi [[kode mesin]], sehingga tidak akan memengaruhi jalannya eksekusi program, performa sistem, atau ukuran biner akhir dari perangkat lunak.

Penulisan komentar yang baik merupakan salah satu aspek krusial dalam rekayasa perangkat lunak untuk menjaga [[keterbacaan]] dan pemeliharaan kode (''maintainability'') dalam jangka panjang, terutama ketika program tersebut dikembangkan oleh sebuah tim pemrogram secara kolaboratif.

== Fungsi dan kegunaan ==
Komentar memiliki beberapa fungsi utama dalam siklus pengembangan perangkat lunak:

* '''Dokumentasi Kode:''' Menjelaskan maksud, logika, atau alasan di balik penulisan suatu [[algoritme]] yang kompleks, sehingga pemrogram lain tidak perlu menebak alur kerja kode tersebut.
* '''Membantu Pengawakutuan (''Commenting Out''):''' Mematikan atau menonaktifkan baris kode tertentu secara sementara selama proses [[pengawakutuan]] (''debugging''). Dengan menjadikannya komentar, baris kode tersebut tidak akan dieksekusi oleh mesin tanpa harus menghapusnya secara permanen dari berkas proyek.
* '''Pembangkitan Dokumentasi Otomatis:''' Beberapa bahasa pemrograman mendukung komentar berformat khusus yang dapat diekstrak oleh perkakas bantu eksternal untuk menghasilkan dokumentasi [[Antarmuka pemrograman aplikasi|API]] berbasis [[HTML]] secara otomatis. Contoh perkakas ini meliputi Javadoc untuk [[Java (bahasa pemrograman)|Java]], JSDoc untuk [[JavaScript]], dan *docstrings* untuk [[Python (bahasa pemrograman)|Python]].
* '''Penanda Tugas (''Tagging''):''' Digunakan untuk meninggalkan catatan kaki bagi tim pengembang mengenai status pengerjaan kode, seperti menggunakan penanda standardisasi <code>TODO</code> (untuk tugas yang belum selesai) atau <code>FIXME</code> (untuk kode cacat yang harus segera diperbaiki).

== Jenis-jenis komentar ==
Gaya dan sintaksis penulisan komentar sangat bergantung pada [[bahasa pemrograman]] yang digunakan, namun secara umum terbagi menjadi tiga jenis:

=== Komentar satu baris (''Single-line comment'') ===
Komentar yang hanya berlaku pada satu baris teks tempat tanda komentar tersebut diletakkan. Segala bentuk teks yang ditulis setelah tanda tersebut hingga akhir baris fisik akan dianggap sebagai komentar.

=== Komentar blok / banyak baris (''Block / Multi-line comment'') ===
Komentar yang digunakan untuk menulis penjelasan panjang yang memakan tempat hingga beberapa baris. Jenis komentar ini membutuhkan tanda pembuka dan tanda penutup yang jelas untuk mengisolasi teks di dalamnya.

=== Komentar dokumentasi (''Documentation comment'') ===
Jenis komentar blok khusus yang diletakkan tepat sebelum deklarasi fungsi, kelas, atau modul untuk menerangkan parameter masukan, tipe kembalian, dan fungsionalitas komponen tersebut kepada sistem dokumentasi otomatis.

== Contoh penerapan ==

Berikut adalah contoh penerapan ketiga jenis komentar tersebut di dalam bahasa pemrograman [[Python (bahasa pemrograman)|Python]]:

== Komentar kepala dan aspek hukum ==
Dalam pengembangan perangkat lunak profesional dan proyek [[perangkat lunak sumber terbuka]], komentar sering diletakkan di bagian paling atas berkas kode sumber (disebut komentar kepala atau *prologue comment*). Komentar ini tidak menjelaskan logika program, melainkan memuat informasi hukum dan [[Hak cipta|kepemilikan]], seperti:
* Nama pencipta atau pemilik hak cipta proyek.
* Tanggal pembuatan atau modifikasi berkas.
* Pernyataan [[Lisensi perangkat lunak|lisensi hukum]] yang mengikat kode tersebut (misalnya ringkasan ketentuan [[Lisensi MIT|MIT]], Apache, atau [[Lisensi Publik Umum GNU|GNU GPL]]).

== Risiko keamanan ==
Meskipun komentar sangat membantu manusia, keberadaannya di dalam kode sumber dapat menimbulkan risiko [[keamanan informasi]] yang serius jika tidak dikelola dengan bijak. Kerentanan ini terdaftar resmi dalam kamus kelemahan umum sebagai **CWE-615** (''Inclusion of Sensitive Information in Source Code Comments'').

Beberapa kesalahan fatal yang sering dilakukan oleh pemrogram meliputi:
* '''Meninggalkan kredensial rahasia:''' Menuliskan [[kata sandi]], kunci API (''API keys''), atau token akses di dalam komentar saat fase pengujian dan lupa menghapusnya ketika kode didistribusikan.
* '''Membocorkan arsitektur internal:''' Memberikan penjelasan terlalu mendetail mengenai kelemahan sistem, alamat [[Alamat IP|IP]] peladen internal, atau struktur [[basis data]] yang dapat dieksploitasi oleh [[peretas]] jika kode sumber tersebut bocor atau berhasil dibongkar melalui [[rekayasa balik]].

== Perbandingan sintaksis ==
Tabel di bawah ini menunjukkan variasi tanda sintaksis penulisan komentar pada beberapa bahasa pemrograman dan penanda teks populer:

== Praktik terbaik ==
Meskipun komentar sangat membantu, penulisan komentar yang buruk justru dapat menurunkan mutu kode sumber. Beberapa praktik terbaik yang disepakati oleh industri meliputi:

* '''Jangan menulis komentar yang sudah jelas:''' Komentar tidak boleh sekadar mengulang apa yang tertulis pada baris logika kode. Sebagai contoh, menulis <code>i = i + 1 // menambah i dengan 1</code> dianggap sebagai limbah visual (*noise*) karena kodenya sendiri sudah sangat jelas.
* '''Tulis kode yang swadokumentasi (''Self-documenting code''):''' Sebelum menulis komentar, pemrogram disarankan untuk menggunakan penamaan variabel dan fungsi yang deskriptif. Kode yang bersih sering kali tidak memerlukan banyak komentar karena strukturnya sudah menerangkan maksudnya sendiri secara eksplisit.
* '''Perbarui komentar secara berkala:''' Komentar yang tidak ikut diperbarui ketika logika kode di bawahnya berubah disebut sebagai "komentar usang" (''rotten comment''). Komentar jenis ini sangat berbahaya karena memberikan informasi yang salah dan menyesatkan bagi pengembang lain.

== Lihat pula ==
* [[Kode sumber]]
* [[Bahasa pemrograman]]
* [[Pengawakutuan]]
* [[Keterbacaan]]

== Referensi ==

== Sumber dan atribusi ==

Konten artikel ini diadaptasi dari [https://id.wikipedia.org/w/index.php?title=Komentar+%28pemrograman%29&oldid=29547938 Wikipedia bahasa Indonesia], revisi 29547938 (2026-08-10T01:17:49Z), yang tersedia berdasarkan lisensi Creative Commons Atribusi-BerbagiSerupa (CC BY-SA). Mohon gunakan konten ini secara bijak serta sesuai dengan ketentuan lisensi yang berlaku.