BAB 5: Komentar dalam Kode

Di bab sebelumnya, # sudah muncul di setiap contoh kode sebagai penanda nama file. Tapi fungsi komentar jauh lebih luas dari itu — dan memahaminya sejak awal akan membentuk kebiasaan menulis kode yang lebih mudah dibaca dan dipelihara.

Komentar Bukan untuk Python

Komentar adalah teks di dalam kode yang diabaikan sepenuhnya oleh Python interpreter. Ketika Python menemukan #, ia berhenti membaca sisa baris itu dan langsung lanjut ke baris berikutnya. Tidak ada yang dieksekusi, tidak ada efek pada program.

Lalu untuk siapa komentar ditulis? Untuk manusia — kamu sendiri saat kembali membaca kode enam bulan kemudian, atau rekan tim yang perlu memahami apa yang kamu tulis.

Komentar Satu Baris

Komentar paling umum di Python menggunakan tanda #. Semua teks setelah # sampai akhir baris adalah komentar.

# hello.py

# Menampilkan salam ke pengguna
print("Halo!")

print("Selamat belajar Python!")  # baris ini selalu dijalankan

Halo!
Selamat belajar Python!

Komentar bisa berdiri sendiri di baris terpisah, atau diletakkan di akhir baris kode yang sudah ada. Keduanya valid — pilih mana yang lebih jelas untuk situasinya.

Komentar juga bisa digunakan untuk menonaktifkan baris kode sementara, misalnya saat debugging:

# hello.py
print("Baris ini dijalankan")
# print("Baris ini dinonaktifkan — tidak akan muncul di output")
print("Baris ini juga dijalankan")

Baris ini dijalankan
Baris ini juga dijalankan

Teknik ini disebut commenting out — sangat berguna saat ingin menguji perilaku program tanpa menghapus kode yang mungkin masih dibutuhkan.

Komentar Multi-baris

Python tidak punya sintaks khusus untuk komentar yang mencakup beberapa baris. Caranya sederhana: tulis # di setiap baris.

# hello.py

# Program ini menampilkan informasi sederhana.
# Ditulis sebagai contoh latihan di Bab 5.
# Bisa dikembangkan dengan variabel di bab berikutnya.
print("Program berjalan dengan baik.")

Program berjalan dengan baik.

Satu hal yang sering ditanyakan pemula: bagaimana dengan """triple quotes"""? Secara teknis, teks di antara triple quotes adalah string, bukan komentar. Jika string itu tidak di-assign ke variabel dan tidak digunakan, Python memang tidak melakukan apa-apa dengannya — tapi itu bukan komentar yang sesungguhnya. Ini perbedaan yang penting untuk dipahami.

Komentar yang Baik vs Komentar yang Sia-sia

Bukan semua komentar berguna. Komentar yang hanya mengulang apa yang sudah jelas dari kode justru menambah noise tanpa nilai.

Contoh komentar yang tidak perlu:

# hello.py

# Mencetak Hello World
print("Hello, World!")

# Mencetak teks kosong
print()

# Mencetak teks kedua
print("Ini baris kedua")

Setiap baris komentar di atas hanya mendeskripsikan apa yang dilakukan kode — padahal kode itu sendiri sudah cukup jelas. Pembaca yang bisa membaca Python tidak perlu diberi tahu bahwa print() mencetak sesuatu.

Komentar yang baik menjelaskan kenapa sesuatu dilakukan, atau memberikan konteks yang tidak bisa dibaca langsung dari kode:

# hello.py

# Gunakan print() kosong untuk memberi jarak visual antar bagian output
print("Nama: Budi")
print()
print("Kota: Surabaya")

Perbedaannya: komentar kedua memberi informasi baru — alasan di balik pilihan teknis — yang tidak bisa disimpulkan hanya dari membaca kode.

Latihan

Ambil kembali file hello.py yang sudah kamu buat di bab sebelumnya. Coba lakukan ini:

1. Tambahkan komentar di atas setiap print() yang menjelaskan kenapa teks itu dicetak, bukan apa yang dicetak.
2. Nonaktifkan salah satu baris print() dengan menambahkan # di depannya. Jalankan dan pastikan baris itu benar-benar tidak muncul di output.
3. Tulis blok komentar tiga baris di atas program yang menjelaskan: apa tujuan program ini, kapan dibuat, dan siapa yang menulisnya.

Perhatikan bagaimana komentar yang kamu tulis mengubah keterbacaan kode — apakah programnya jadi lebih mudah dipahami, atau justru lebih ramai tanpa manfaat?

Komentar membuat kode lebih mudah dibaca, tapi kode itu sendiri belum menyimpan data apa pun — semua teks di print() masih ditulis keras ke dalam kode. Untuk membuat program yang bisa menyimpan dan mengolah data secara dinamis, kita butuh variabel. Itulah topik yang akan kita bahas di bab selanjutnya.