Penamaan Variabel yang Baik di Python

Dalam dunia pemrograman Python, penamaan variabel merupakan salah satu hal paling mendasar namun sangat penting untuk menjaga keterbacaan kode dan konsistensi proyek. Variabel adalah wadah untuk menyimpan data, dan cara Anda menamainya bisa menentukan seberapa mudah orang lain (atau bahkan Anda sendiri di masa depan) memahami kode tersebut. Artikel ini membahas secara lengkap tentang aturan, konvensi, serta contoh penerapan penamaan variabel yang baik di Python.

Mengapa Penamaan Variabel Penting?

Penamaan variabel bukan sekadar memberi nama sembarangan. Nama variabel yang baik membantu:

• Menjelaskan maksud data yang disimpan.
• Meningkatkan keterbacaan kode (readability).
• Menghindari kebingungan dengan nama fungsi atau modul lain.
• Mempermudah debugging dan pemeliharaan kode.

Misalnya, bandingkan dua contoh berikut:

# Contoh 1: Penamaan buruk
x = 100
y = 200
z = x + y
print(z)

# Contoh 2: Penamaan baik
harga_barang = 100
biaya_pengiriman = 200
total_biaya = harga_barang + biaya_pengiriman
print(total_biaya)

Contoh pertama memang berfungsi, tapi tidak mudah dipahami. Pada contoh kedua, pembaca langsung tahu maksud setiap variabel tanpa perlu membaca komentar tambahan.

Aturan Dasar Penamaan Variabel Python

Sebelum membahas gaya penamaan yang baik, mari pahami dulu aturan teknis dalam Python:

• Nama variabel hanya boleh berisi huruf (a-z, A-Z), angka (0-9), dan garis bawah (_).
• Tidak boleh diawali dengan angka.
  ✅ nama1 sah, ❌ 1nama tidak sah.
• Bersifat case-sensitive, artinya data dan Data dianggap dua variabel berbeda.
• Tidak boleh menggunakan reserved keywords seperti for, while, if, class, dll.

# Contoh variabel sah
nama_pengguna = "Nida"
usia = 25
is_active = True

# Contoh variabel tidak sah
# 1nama = "Andi"   # Salah karena diawali angka
# for = 10         # Salah karena kata kunci Python

Konvensi Penamaan Berdasarkan PEP 8

Python memiliki panduan resmi bernama PEP 8 (Python Enhancement Proposal 8) yang mengatur gaya penulisan kode. Dalam PEP 8, gaya penamaan variabel mengikuti prinsip snake_case, yaitu menggunakan huruf kecil dengan garis bawah sebagai pemisah antar kata.

# Gaya penulisan variabel sesuai PEP 8
total_harga = 50000
nama_barang = "Mouse Wireless"
jumlah_barang = 2

Hindari gaya lain seperti camelCase atau PascalCase untuk variabel, karena biasanya digunakan untuk hal berbeda:

• snake_case → variabel dan fungsi
• PascalCase → nama kelas
• UPPER_CASE → konstanta

# Contoh penggunaan sesuai konteks
nama_lengkap = "Ari Setiawan"      # variabel
def hitung_total(): pass           # fungsi
class DataPengguna: pass           # kelas
MAX_RETRY = 5                      # konstanta

Tips Penamaan Variabel yang Baik

1. Gunakan nama yang deskriptif
   Nama harus menjelaskan isi atau tujuan variabel.
   ✅ jumlah_siswa lebih baik daripada ❌ js.
2. Gunakan bahasa konsisten
   Jika Anda menulis kode dalam bahasa Indonesia, konsistenlah. Jangan campur dengan bahasa Inggris secara acak.
   Misal gunakan semua variabel dalam bahasa Inggris: total_price, item_name.
   Atau semua dalam bahasa Indonesia: total_harga, nama_barang.
3. Hindari singkatan berlebihan
   ❌ ttlHrg → tidak jelas.
   ✅ total_harga → jelas dan mudah dibaca.
4. Gunakan garis bawah untuk pemisah kata
   Python menyarankan gaya snake_case agar mudah dibaca.
5. Gunakan awalan boolean untuk nilai logika
   Misalnya variabel yang menyimpan nilai True/False sebaiknya diawali dengan is_, has_, atau can_.

# Contoh penamaan boolean
is_active = True
has_paid = False
can_login = True

Contoh Kasus: Penulisan Variabel pada Program Sederhana

Berikut contoh kecil bagaimana penamaan variabel yang baik membuat program terlihat bersih dan mudah dipahami:

# Program menghitung total belanja pelanggan

# Penamaan baik
nama_pelanggan = "Dina"
harga_barang = 75000
jumlah_barang = 3
diskon = 0.1  # 10%

total_sebelum_diskon = harga_barang * jumlah_barang
total_setelah_diskon = total_sebelum_diskon - (total_sebelum_diskon * diskon)

print(f"Nama Pelanggan : {nama_pelanggan}")
print(f"Total Sebelum Diskon : Rp{total_sebelum_diskon}")
print(f"Total Setelah Diskon : Rp{total_setelah_diskon}")

Dibandingkan dengan kode berikut yang menggunakan penamaan buruk:

# Penamaan buruk
n = "Dina"
h = 75000
j = 3
d = 0.1

ts = h * j
ta = ts - (ts * d)

print(f"Nama: {n}")
print(f"Total: {ta}")

Kedua program menghasilkan output yang sama, namun kode pertama jauh lebih jelas dan profesional.

Kesalahan Umum dalam Penamaan Variabel

• Menggunakan nama terlalu pendek seperti x, y tanpa konteks.
• Menyalahi aturan huruf kecil besar (camelCase).
• Menamai variabel sama dengan fungsi bawaan Python (misal list, max, sum).

# Hindari ini!
list = [1, 2, 3]    # Menimpa fungsi bawaan 'list'
max = 100            # Menimpa fungsi bawaan 'max'

# Sebaiknya
daftar_angka = [1, 2, 3]
nilai_maksimum = 100

Kesimpulan

Penamaan variabel yang baik di Python adalah salah satu keterampilan penting untuk menjadi developer profesional. Mengikuti panduan PEP 8, menggunakan snake_case, dan memilih nama yang deskriptif akan membuat kode Anda lebih bersih, efisien, dan mudah dipahami. Jadi, mulai sekarang, biasakan menulis variabel dengan nama yang bermakna — karena kode yang baik bukan hanya yang berjalan, tapi juga yang bisa dibaca dengan mudah oleh manusia.