BAB 5: Menguasai Komentar di Python untuk Kode yang Lebih Jelas - Abd. Asis

BAB 5: Menguasai Komentar di Python untuk Kode yang Lebih Jelas

Setelah kamu berhasil menjalankan program Hello World, sekarang waktunya belajar teknik penting agar kode Python kamu mudah dipahami—yaitu komentar.

Kenapa Komentar Penting?

Komentar adalah “catatan kaki” di dalam kode. Komentar tidak dijalankan oleh Python interpreter, tapi sangat membantu kamu (dan orang lain) memahami maksud kode, menandai bagian penting, atau menonaktifkan kode sementara.

Komentar bikin proses belajar dan kolaborasi jadi lebih lancar. Bayangkan komentar seperti sticky note di buku pelajaran—bisa jadi pengingat, penjelasan, atau catatan revisi.

Jenis Komentar di Python

Python mengenal dua jenis komentar:

  • Komentar satu baris
  • Komentar multi-baris

Komentar Satu Baris

Komentar satu baris ditulis dengan karakter # di awal baris. Semua teks setelah # tidak akan dieksekusi.

# ini adalah komentar
print("halo,")
print("selamat pagi!") # ini juga komentar

# println("statement ini tidak akan dipanggil")

Output:

halo,
selamat pagi!

Penjelasan:

  • Baris yang diawali # tidak dijalankan.
  • Komentar bisa ditulis di akhir baris kode untuk memberi penjelasan.
  • Statement yang dikomentari tidak akan muncul di output.

Komentar Multi-baris

Ada dua cara membuat komentar multi-baris di Python:

1. Menggunakan # di setiap baris

# ini adalah komentar
# ini juga komentar
# komentar baris ke-3
print("komentar multi-baris dengan #")

Output:

komentar multi-baris dengan #

2. Menggunakan Triple Quotes (""" atau ''')

Triple quotes biasanya dipakai untuk multiline string, tapi juga bisa digunakan sebagai komentar multi-baris.

"""
ini adalah komentar
ini juga komentar
komentar baris ke-3
"""
print("komentar multi-baris dengan triple quotes")

Output:

komentar multi-baris dengan triple quotes

Triple quotes juga bisa dipakai untuk komentar satu baris:

"""ini adalah komentar satu baris"""
print("komentar satu baris dengan triple quotes")

Output:

komentar satu baris dengan triple quotes

Pembahasan detail tentang string ada di bab khusus. Untuk DocString (dokumentasi function/class/module), akan dibahas di bab DocString.

Praktik & Tips Komentar Python

  • Gunakan komentar untuk menjelaskan “kenapa” bukan hanya “apa”.
  • Hindari komentar yang terlalu obvious (misal: # print pesan ke layar di atas print()).
  • Komentar bisa dipakai untuk menonaktifkan kode saat debugging.
  • Komentar multi-baris cocok untuk penjelasan panjang atau catatan revisi.
  • Untuk dokumentasi function/class/module, gunakan DocString (triple quotes di dalam function/class).

Sumber Referensi

Review Pembelajaran

Di bab ini, kamu sudah belajar:

  • Fungsi dan manfaat komentar di Python
  • Cara membuat komentar satu baris dan multi-baris
  • Praktik terbaik menulis komentar
  • Perbedaan komentar dan DocString

Bab berikutnya, kita akan membahas tuntas tentang komentar di Python—cara membuat, manfaat, dan praktik terbaik. Siap lanjut?