Komentar dalam Python

Ketika membuat program, kode yang ditulis tidak hanya akan dibaca oleh komputer, tetapi juga akan dibaca oleh manusia. Semakin panjang sebuah program, semakin banyak pula baris kode yang harus dipahami. Pada program sederhana, maksud setiap baris mungkin masih mudah diketahui. Namun, ketika program sudah terdiri atas puluhan, ratusan, bahkan ribuan baris, akan menjadi lebih sulit untuk mengingat fungsi dari setiap bagian program.

Python menyediakan fitur yang disebut komentar untuk membantu mengatasi masalah tersebut.

Komentar adalah catatan yang ditambahkan ke dalam kode program untuk memberikan keterangan kepada pembaca. Komentar tidak digunakan untuk menjalankan perintah tertentu. Python akan mengabaikan komentar ketika program dijalankan. Dengan demikian, komentar dapat digunakan untuk menjelaskan maksud sebuah bagian program tanpa mengubah hasil yang dihasilkan oleh program.

Contoh sederhana:
# Menampilkan pesan kepada pengguna
print("Selamat belajar Python")

Pada contoh tersebut, baris yang diawali tanda `#` merupakan komentar. Sementara itu, baris `print()` merupakan perintah yang dijalankan oleh Python.

Hasil program:
Selamat belajar Python

Komentar tidak muncul pada keluaran program.

## Mengapa Komentar Dibutuhkan?

Pada awal belajar Python, komentar mungkin terlihat tidak terlalu penting. Program yang dibuat siswa biasanya masih pendek sehingga maksud setiap baris mudah diingat. Namun, komentar akan menjadi semakin berguna ketika program mulai bertambah panjang.

Bayangkan terdapat sebuah program yang terdiri atas 500 baris. Setelah program selesai dibuat, program tersebut tidak digunakan selama beberapa bulan. Ketika dibuka kembali, mungkin terdapat beberapa bagian yang sudah sulit dipahami. Komentar dapat membantu mengingat alasan dan tujuan dibuatnya bagian tertentu.

Komentar juga berguna ketika sebuah program dikerjakan secara berkelompok. Satu siswa dapat menulis bagian tertentu, sedangkan siswa lain melanjutkan pekerjaan tersebut. Komentar dapat menjadi petunjuk agar anggota kelompok memahami fungsi suatu bagian program.

Dengan demikian, komentar memiliki beberapa manfaat, antara lain:

• Membantu menjelaskan tujuan kode.
• Membuat program lebih mudah dibaca.
• Membantu mengingat fungsi bagian tertentu.
• Membantu proses pemeriksaan kesalahan.
• Mempermudah kerja sama dalam pembuatan program.
• Memberikan catatan bagi pengembang ketika program dikembangkan kembali.

## Tanda `#` untuk Membuat Komentar

Cara paling dasar untuk membuat komentar dalam Python adalah menggunakan tanda pagar `#`.

Semua tulisan yang berada setelah tanda `#` sampai akhir baris dianggap sebagai komentar. Python tidak menjalankan bagian tersebut sebagai perintah program.

Contoh:
# Ini adalah komentar
print("Python sangat menarik")

Python hanya menjalankan:
print("Python sangat menarik")

Komentar yang berada di atas perintah tidak memengaruhi keluaran program.

## Komentar Satu Baris

Komentar yang hanya digunakan pada satu baris disebut komentar satu baris.

Contoh:
# Menampilkan nama siswa
print("Andi")

Pada contoh tersebut, komentar memberikan informasi mengenai tujuan baris berikutnya.

Komentar juga dapat digunakan untuk menjelaskan sebuah nilai.
# Menyimpan jumlah siswa
jumlah_siswa = 32

Komentar tersebut membantu pembaca memahami bahwa angka `32` digunakan sebagai jumlah siswa.

## Komentar di Samping Kode

Komentar tidak harus selalu ditempatkan pada baris tersendiri. Komentar juga dapat ditulis setelah perintah.

Contoh:
print("Halo") # Menampilkan sapaan

Python menjalankan bagian `print("Halo")`, sedangkan bagian setelah `#` hanya dianggap sebagai catatan.

Cara seperti ini berguna untuk memberikan keterangan singkat pada suatu baris. Namun, komentar di samping kode sebaiknya tidak dibuat terlalu panjang agar kode tetap mudah dibaca.

## Contoh Penggunaan Komentar

Perhatikan program berikut:
# Menampilkan identitas siswa
print("Nama: Budi")
print("Kelas: X")
print("Jurusan: Informatika")

Program tersebut sebenarnya dapat dijalankan tanpa komentar. Namun, komentar memberikan informasi tambahan bahwa tiga baris tersebut digunakan untuk menampilkan identitas siswa.

Contoh lain:
# Menampilkan judul program
print("DATA SISWA")

# Menampilkan informasi siswa
print("Nama: Rina")
print("Kelas: XI")

Komentar dapat digunakan untuk membagi program menjadi beberapa bagian sehingga struktur kode lebih mudah dipahami.

## Komentar untuk Memberikan Catatan

Komentar juga dapat digunakan untuk memberikan catatan kepada pembuat program.

Misalnya:
# Periksa kembali data sebelum program digunakan
print("Data siswa")

Atau:

# Bagian ini akan dikembangkan pada latihan berikutnya
print("Menu utama")

Komentar seperti ini berguna selama proses pembuatan program.

## Membuat Komentar Beberapa Baris

Python tidak mempunyai bentuk khusus yang secara langsung disebut sebagai sintaks komentar beberapa baris seperti yang tersedia pada beberapa bahasa pemrograman lain. Salah satu cara yang jelas untuk membuat komentar beberapa baris adalah memberikan tanda `#` pada setiap baris.

Contoh:
# Program ini digunakan untuk menampilkan
# informasi sederhana mengenai siswa.
# Data dapat dikembangkan pada latihan berikutnya.
print("Nama: Budi")
print("Kelas: X")

Ketiga baris pertama merupakan komentar.

Cara tersebut cukup mudah dipahami karena setiap baris secara jelas ditandai sebagai komentar.

## Komentar Panjang dengan Beberapa Tanda `#`

Jika terdapat penjelasan yang cukup panjang, setiap baris dapat diawali dengan `#`.

Contoh:
# Program sederhana untuk menampilkan
# daftar mata pelajaran.
# Setiap mata pelajaran ditampilkan
# menggunakan perintah print().
print("Matematika")
print("Bahasa Indonesia")
print("Informatika")

Penulisan seperti ini membuat fungsi setiap bagian program menjadi lebih jelas.

## String Tiga Tanda Petik

Dalam Python terdapat bentuk teks yang menggunakan tiga tanda petik, baik tiga tanda petik tunggal maupun tiga tanda petik ganda.

Contohnya:
"""
Program sederhana untuk
menampilkan data siswa.
"""
print("Nama: Andi")

Perlu dipahami bahwa bentuk tersebut sebenarnya merupakan teks atau string, bukan sintaks komentar khusus Python. Teks seperti ini dapat memiliki fungsi dokumentasi dalam situasi tertentu, terutama sebagai dokumentasi pada fungsi, kelas, atau modul. Karena itu, untuk komentar biasa yang hanya bertujuan memberikan catatan pada kode, penggunaan `#` lebih jelas dan lebih tepat.

## Komentar untuk Menonaktifkan Perintah

Salah satu kegunaan praktis komentar adalah menonaktifkan sementara sebuah baris kode.

Misalnya terdapat program:
print("Baris pertama")
print("Baris kedua")
print("Baris ketiga")

Jika ingin sementara tidak menjalankan baris kedua, baris tersebut dapat diberi tanda `#`.
print("Baris pertama")
# print("Baris kedua")
print("Baris ketiga")

Hasilnya:
Baris pertama
Baris ketiga

Baris kedua tidak dijalankan karena sudah berubah menjadi komentar.

Cara ini sering digunakan ketika melakukan percobaan terhadap program. Daripada menghapus kode yang mungkin masih diperlukan, kode tersebut dapat dinonaktifkan sementara.

## Komentar dalam Proses Mencari Kesalahan

Ketika program mengalami kesalahan, salah satu cara untuk mencari sumber masalah adalah menonaktifkan bagian program secara bertahap.

Contoh:
angka1 = 20
angka2 = 10
print(angka1 + angka2)
print("Program selesai")

Jika terdapat bagian program yang ingin diuji secara terpisah, salah satu baris dapat dinonaktifkan:
angka1 = 20
angka2 = 10
print(angka1 + angka2)
# print("Program selesai")

Dengan cara tersebut, bagian tertentu dapat dikeluarkan sementara dari proses pelaksanaan program tanpa menghapusnya.

Komentar memang dapat membantu dalam proses pencarian kesalahan, tetapi bukan berarti seluruh kesalahan harus diselesaikan dengan memberi tanda `#`. Setelah sumber masalah ditemukan, kode sebaiknya diperbaiki agar program dapat berjalan dengan benar.

## Komentar untuk Menjelaskan Tujuan

Komentar yang baik sebaiknya memberikan informasi yang benar-benar berguna.

Perhatikan contoh berikut:
# Menampilkan nama
print(nama)

Komentar tersebut masih cukup sederhana.

Komentar dapat dibuat lebih informatif apabila menjelaskan tujuan:
# Menampilkan nama pengguna setelah data berhasil dimasukkan
print(nama)

Komentar kedua memberikan informasi lebih banyak mengenai alasan perintah tersebut digunakan.

## Jangan Terlalu Banyak Menggunakan Komentar

Komentar memang bermanfaat, tetapi terlalu banyak komentar juga dapat membuat kode menjadi sulit dibaca.

Contoh yang kurang baik:
# Menampilkan
print("Halo") # Perintah print

Komentar tersebut tidak terlalu diperlukan karena fungsi `print()` sudah cukup jelas.

Komentar sebaiknya digunakan ketika terdapat informasi yang perlu diketahui pembaca dan tidak dapat dipahami dengan mudah hanya dengan melihat kode.

## Komentar Sebaiknya Menjelaskan Alasan

Komentar yang baik sering kali digunakan untuk menjelaskan alasan suatu keputusan dalam program.

Misalnya:
# Menggunakan batas 100 karena data hanya mencakup
# siswa dengan nilai maksimal yang telah ditentukan.
batas = 100

Komentar tersebut lebih berguna daripada sekadar:
# Menentukan batas
batas = 100

Dengan demikian, komentar tidak hanya menjelaskan apa yang dilakukan program, tetapi dapat memberikan alasan mengapa bagian tersebut dibuat dengan cara tertentu.

## Membuat Program Lebih Teratur

Komentar dapat digunakan sebagai penanda bagian-bagian program.

Contoh:
# ==========================
# DATA SISWA
# ==========================

print("Nama: Andi")
print("Kelas: X")

# ==========================
# DATA SEKOLAH
# ==========================

print("SMA")
print("Informatika")

Cara tersebut dapat membantu ketika program sudah memiliki banyak bagian.

Namun, penggunaan tanda pembatas sebaiknya tetap sederhana. Tujuannya adalah membuat program lebih mudah dibaca, bukan memenuhi program dengan komentar dekoratif.

## Komentar dan Kerja Kelompok

Dalam pembelajaran Informatika, sebuah program terkadang dibuat secara berkelompok. Setiap anggota kelompok dapat mengerjakan bagian yang berbeda.

Misalnya:
# Bagian tampilan dibuat oleh Andi
print("MENU UTAMA")

# Bagian data dibuat oleh Rina
print("Data siswa")

# Bagian pengujian dibuat oleh Budi
print("Pengujian selesai")

Komentar tersebut dapat membantu anggota kelompok mengetahui bagian yang sedang dikerjakan.

Namun, dalam proyek yang sebenarnya, komentar sebaiknya tidak hanya digunakan untuk mencatat nama pembuat. Lebih penting untuk menjelaskan fungsi atau alasan suatu bagian program.

## Pintasan Keyboard untuk Komentar

Editor kode modern biasanya menyediakan pintasan keyboard untuk mengubah baris kode menjadi komentar atau mengembalikannya menjadi kode biasa. Pada banyak editor, kombinasi yang umum digunakan adalah `Ctrl + /` pada Windows dan `Cmd + /` pada macOS, meskipun pintasan dapat berbeda tergantung aplikasi yang digunakan.

Contohnya, terdapat kode:
print("Satu")
print("Dua")
print("Tiga")

Beberapa baris dapat dipilih terlebih dahulu, kemudian menggunakan pintasan komentar. Editor dapat mengubahnya menjadi:
# print("Satu")
# print("Dua")
# print("Tiga")

Cara tersebut sangat membantu ketika menguji program yang memiliki banyak baris.

## Contoh Program dengan Komentar

Berikut contoh program sederhana yang menggunakan beberapa komentar.
# Menampilkan judul
print("DATA NILAI SISWA")

# Menampilkan identitas
print("Nama: Sinta")
print("Kelas: X")

# Menampilkan nilai
nilai = 85
print("Nilai:", nilai)

Komentar membantu pembaca mengetahui bahwa program memiliki tiga bagian utama, yaitu judul, identitas, dan nilai.

## Latihan 1

Buatlah program yang menampilkan nama, kelas, dan sekolah.

Tambahkan komentar yang menjelaskan fungsi setiap bagian.

Contoh kerangka:
# Identitas siswa
print("Nama: ...")
print("Kelas: ...")

# Informasi sekolah
print("Sekolah: ...")

## Latihan 2

Buatlah program yang menampilkan lima mata pelajaran.

Gunakan komentar untuk menjelaskan bahwa bagian tersebut digunakan untuk menampilkan daftar mata pelajaran.

## Latihan 3

Buatlah program berikut:
print("Belajar Python")
print("Komentar membantu")
print("Kode lebih mudah dipahami")

Kemudian tambahkan komentar pada bagian-bagian yang dianggap penting.

## Latihan 4

Buatlah program dengan tiga perintah `print()`. Setelah itu, jadikan perintah kedua sebagai komentar. Amati perubahan keluaran program.

## Latihan 5

Buatlah program identitas siswa yang memiliki minimal lima informasi. Tambahkan komentar untuk mengelompokkan informasi tersebut.

## Kesalahan yang Perlu Dihindari

Ada beberapa kebiasaan yang sebaiknya dihindari ketika menggunakan komentar.

• Pertama, jangan menulis komentar yang tidak sesuai dengan kode.
• Contoh:
• # Menampilkan nama
• print("Alamat: Semarang")
• Komentar tersebut membingungkan karena tidak sesuai dengan perintah.
• Kedua, jangan menggunakan komentar untuk menggantikan kode yang seharusnya diperbaiki.
• Ketiga, jangan memberikan komentar pada setiap baris jika kode tersebut sudah sangat jelas.
• Keempat, jangan membuat komentar terlalu panjang sehingga justru mengganggu pembacaan program.

Komentar yang baik harus singkat, jelas, benar, dan memiliki tujuan.

## Kesimpulan

Komentar merupakan bagian penting dalam pemrograman Python. Komentar digunakan sebagai catatan bagi manusia yang membaca kode dan tidak dijalankan sebagai perintah oleh Python. Bentuk paling sederhana dibuat menggunakan tanda `#`. Tanda tersebut dapat ditempatkan pada awal baris atau setelah sebuah perintah.

Komentar dapat digunakan untuk menjelaskan tujuan kode, mengelompokkan bagian program, memberikan catatan, membantu proses pencarian kesalahan, serta menonaktifkan sementara suatu perintah. Python tidak menyediakan sintaks khusus untuk komentar beberapa baris; pendekatan yang jelas adalah memberikan `#` pada setiap baris yang ingin dijadikan komentar. Teks dengan tiga tanda petik memiliki fungsi sebagai string dan dapat digunakan untuk dokumentasi tertentu, tetapi sebaiknya tidak dianggap sebagai pengganti komentar biasa.

Bagi siswa yang baru belajar Python, kemampuan menggunakan komentar sebaiknya mulai dibiasakan sejak membuat program sederhana. Program yang rapi dan mudah dibaca akan membantu proses belajar ketika materi berkembang menjadi lebih kompleks.

Komentar bukan sekadar tulisan tambahan dalam program. Penggunaan komentar yang tepat merupakan salah satu kebiasaan pemrograman yang membantu menjaga kode tetap mudah dipahami, terutama ketika program semakin panjang dan dikerjakan bersama orang lain.

Location: Kota Semarang, Jawa Tengah, Indonesia

Berbagi :