Pendamping Bab 4: Komentar Python: Menjelaskan Maksud Code. Gunakan nomor contoh dan latihan yang sama dengan buku.

Tujuan Belajar

  • Menulis komentar dengan tanda #.
  • Membedakan komentar dengan string.
  • Memilih komentar yang menjelaskan alasan atau tujuan.

Persiapan

Kamu sudah dapat menjalankan print dan mengenali indentasi. Contoh inti menggunakan perintah yang sudah dipelajari.

Program dengan tombol Coba di IDE dapat dijalankan di browser. Untuk program lokal, unduh sumber, ekstrak ZIP, lalu ikuti README.txt.

Pembahasan

04-01 – Komentar Baris Tunggal

Instruksi dijalankan dari atas ke bawah; print menampilkan nilai saat instruksi itu dijalankan.

Coba di IDE Unduh Sumber
# Ini komentar
print("Halo!")  # Ini juga komentar

Hasil yang diharapkan:

Halo!

Coba ubah: Ubah satu nilai pada contoh, lalu jelaskan pengaruhnya terhadap hasil.

04-02 – Menonaktifkan Sementara Code

Komentar juga bisa digunakan untuk menonaktifkan code sementara waktu saat sedang diuji atau diperbaiki.

Coba di IDE Unduh Sumber
# print("Bagian ini belum aktif")
print("Code utama jalan")

Hasil yang diharapkan:

Code utama jalan

Coba ubah: Ubah satu nilai pada contoh, lalu jelaskan pengaruhnya terhadap hasil.

Studi Kasus

04-03 – Pesan pengingat yang mudah dirawat

Komentar menjelaskan keputusan menonaktifkan pesan percobaan. Dua pesan lainnya tetap dijalankan.

Coba di IDE Unduh Sumber
# Pesan percobaan dinonaktifkan sebelum program dibagikan.
print("Siapkan buku dan catatan.")
# print("Pesan percobaan")
print("Mulai belajar selama 15 menit.")

Hasil yang diharapkan:

Siapkan buku dan catatan.
Mulai belajar selama 15 menit.

Coba ubah: Aktifkan pesan percobaan, lalu bandingkan jumlah baris output.

Rangkuman

Komentar # tidak dijalankan sebagai instruksi. Gunakan komentar untuk maksud, alasan, atau batasan yang belum jelas dari code. String tiga tanda petik tetap merupakan string; docstring dibahas pada Bab 11.

Cek Pemahaman

Lima pertanyaan ini sama dengan pertanyaan di buku. Periksa jawaban di kuis untuk melihat skor dan pembahasan.

  1. Apa tanda awal komentar satu baris?
  2. Apa yang terjadi pada baris # print("Halo")?
  3. Komentar yang paling membantu menjelaskan …
  4. Teks # di dalam tanda petik adalah …
  5. String tiga tanda petik otomatis menjadi komentar Python?
Kerjakan Kuis

Latihan Mandiri

Latihan 04-L01 – Tujuan program

Dasar. Tambahkan komentar tujuan sebelum print yang menampilkan Jadwal belajar.

Kerjakan di IDE Unduh Latihan

Hasil yang diharapkan:

Jadwal belajar
Lihat Petunjuk

Tulis komentar pada baris sebelum print.

Lihat Solusi
# Menampilkan judul catatan belajar.
print("Jadwal belajar")

Komentar tidak mengubah output.

Coba Solusi di IDEUnduh Solusi

Latihan 04-L02 – Menonaktifkan pesan

Penerapan. Tampilkan Mulai dan Selesai. Nonaktifkan print Debug dengan komentar.

Kerjakan di IDE Unduh Latihan

Hasil yang diharapkan:

Mulai
Selesai
Lihat Petunjuk

Tambahkan # sebelum print yang ingin dinonaktifkan.

Lihat Solusi
print("Mulai")
# print("Debug")
print("Selesai")

Hanya dua instruksi print yang dijalankan.

Coba Solusi di IDEUnduh Solusi

Latihan 04-L03 – Karakter pagar

Pengembangan. Tampilkan #BelajarPython sebagai teks dan beri komentar yang menjelaskan bahwa pagar itu bagian pesan.

Kerjakan di IDE Unduh Latihan

Hasil yang diharapkan:

#BelajarPython
Lihat Petunjuk

Letakkan pesan di antara tanda petik.

Lihat Solusi
# Tanda pagar di dalam tanda petik adalah teks.
print("#BelajarPython")

Pagar di dalam literal string tidak memulai komentar.

Coba Solusi di IDEUnduh Solusi

Pengembangan

Kegiatan Tambahan

  1. Program Pertamaku dengan Komentar: Buka kembali program HaloDunia.py yang kamu buat di bab sebelumnya (Bab 2).

    • Tambahkan komentar di baris paling atas yang berisi namamu dan tanggal kamu membuat/mengedit file tersebut (misalnya: # Nama: Budi, Tanggal: 11 Mei 2025).
    • Tambahkan komentar di samping baris print("Halo, Dunia!") yang menjelaskan apa yang dilakukan baris code itu (misalnya: # Mencetak pesan sapaan ke layar).

  2. Eksperimen Menonaktifkan Code:

    • Di bawah code print("Halo, Dunia!") dalam file HaloDunia.py (atau buat file baru jika perlu), tambahkan dua baris code baru:

      print("Saya sedang belajar Python!")
print("Python itu seru!")

    • Jalankan programnya. Kamu seharusnya melihat tiga baris teks tercetak.

    • Sekarang, gunakan komentar untuk menonaktifkan baris print("Saya sedang belajar Python!"). Caranya, tambahkan # di awal baris tersebut.

    • Jalankan programnya lagi. Apa yang kamu lihat berbeda? Baris mana yang tidak muncul?

  3. Komentar yang Tepat Guna: Perhatikan potongan code berikut. Menurutmu, apakah komentar yang ada sudah baik dan tepat guna? Jika ada yang kurang pas, bagaimana kamu akan memperbaikinya agar lebih baik?

    # Program untuk menampilkan pesan selamat datang

# Cetak garis pembatas atas
print("=" * 30) # tampilkan garis sama dengan

# Cetak judul
print("Selamat Datang di Python!") # ini adalah judul

# Cetak garis pembatas bawah
print("=" * 30) # tampilkan garis sama dengan lagi

# Cetak pesan sambutan
print("Halo!") # cetak kata halo

# Cetak pesan motivasi
print("Selamat belajar!") # tampilkan pesan motivasi

    Petunjuk: Pikirkan tentang komentar mana yang benar-benar membantu pemahaman, dan mana yang hanya mengulang apa yang sudah terlihat jelas dari code. Apakah semua komentar itu diperlukan?

Petunjuk dan Solusi Pengembangan
Klik untuk melihat contoh perbaikan dan diskusi

Banyak komentar di atas sebenarnya tidak diperlukan karena codenya sudah cukup jelas (self-documenting). Berikut adalah versi yang lebih ringkas:

“`python # Program untuk menampilkan pesan selamat datang

print(“=” * 30) print(“Selamat Datang di Python!”) print(“=” * 30) print(“Halo!”) print(“Selamat belajar!”) “` Diskusi:

  • Komentar # Program untuk menampilkan pesan selamat datang di awal masih berguna sebagai deskripsi umum program.
    • Komentar seperti # Cetak judul dan # ini adalah judul tidak diperlukan karena teks “Selamat Datang di Python!” sudah jelas menunjukkan bahwa itu adalah judul.
    • Komentar # cetak kata halo untuk print("Halo!") juga tidak menambah nilai karena code-nya sudah sangat jelas.
    • Komentar # tampilkan garis sama dengan terlalu literal dan tidak membantu. Jika perlu, lebih baik jelaskan mengapa (misalnya: # Garis pembatas untuk estetika), bukan hanya apa.
    • Untuk code yang sangat sederhana seperti ini, komentar paling berguna adalah di awal program untuk menjelaskan tujuan keseluruhan program.
    Intinya adalah: jangan beri komentar pada hal yang sudah jelas dari code itu sendiri. Fokus pada komentar yang memberikan konteks atau menjelaskan logika yang tidak langsung terlihat.

Referensi dan Materi Pendamping

Langkah Selanjutnya

Bab 5 membahas Variabel dan Tipe Data Dasar. Sebelum melanjutkan, pastikan kamu dapat menjelaskan tujuan belajar dan menyelesaikan tiga latihan inti bab ini.

Edisi September 2026. Nomor contoh, pertanyaan, dan latihan digunakan bersama pada buku dan halaman ini.

Bab 3 | Bab 5