Bagaimana Menulis Kode yang Rapi dan Mudah Dibaca?

Menulis kode bukan hanya soal membuat program yang berjalan, tetapi juga memastikan kode tersebut mudah dibaca, dipahami, dan dikelola oleh orang lain (termasuk diri sendiri di masa depan). Prinsip clean code membantu developer membuat kode yang lebih terstruktur dan efisien. Artikel ini akan membahas praktik terbaik dalam menulis kode yang rapi dan mudah dibaca.

1. Gunakan Penamaan Variabel yang Jelas

Hindari nama variabel yang terlalu singkat atau ambigu. Gunakan nama yang menggambarkan fungsinya secara jelas.

❌ Buruk:

javascriptCopyEditlet x = 10;
let y = x * 2;

✅ Baik:

javascriptCopyEditlet itemPrice = 10;
let totalPrice = itemPrice * 2;

2. Gunakan Indentasi dan Format yang Konsisten

Gunakan indentasi yang jelas agar kode lebih mudah dibaca. Sebagian besar bahasa pemrograman merekomendasikan indentasi 2 atau 4 spasi.

❌ Buruk:

pythonCopyEditdef add(a,b):return a+b

✅ Baik:

pythonCopyEditdef add(a, b):
    return a + b

3. Hindari Kode yang Terlalu Panjang dalam Satu Baris

Kode yang terlalu panjang sulit dibaca. Gunakan pemisahan logis untuk meningkatkan keterbacaan.

❌ Buruk:

javaCopyEditif(user.isActive() && user.hasPermission("admin") && user.getLastLogin() > 0) { doSomething(); }

✅ Baik:

javaCopyEditif (user.isActive() && 
    user.hasPermission("admin") && 
    user.getLastLogin() > 0) { 
    doSomething(); 
}

4. Hindari Magic Numbers dan Strings

Gunakan konstanta daripada angka atau string yang sulit dimengerti dalam kode.

❌ Buruk:

cCopyEditif (score > 60) {
    printf("Lulus");
}

✅ Baik:

cCopyEditconst int PASSING_SCORE = 60;
if (score > PASSING_SCORE) {
    printf("Lulus");
}

5. Buat Fungsi yang Fokus pada Satu Tugas

Setiap fungsi sebaiknya hanya menangani satu tugas agar mudah diuji dan dipelihara.

❌ Buruk:

phpCopyEditfunction processUser($user) {
    validateUser($user);
    saveToDatabase($user);
    sendEmail($user);
}

✅ Baik:

phpCopyEditfunction validateUser($user) { /* ... */ }
function saveUserToDatabase($user) { /* ... */ }
function sendWelcomeEmail($user) { /* ... */ }

6. Tambahkan Komentar yang Berguna

Komentar harus membantu menjelaskan mengapa kode ditulis, bukan apa yang sudah jelas dari kode itu sendiri.

❌ Buruk:

cppCopyEditi = i + 1; // Menambahkan 1 ke i

✅ Baik:

cppCopyEdit// Menambahkan 1 untuk memperbarui jumlah item dalam keranjang belanja
cartItemCount += 1;

Kesimpulan

Menulis kode yang rapi dan mudah dibaca sangat penting untuk meningkatkan produktivitas dan mengurangi potensi bug. Gunakan penamaan variabel yang jelas, format yang konsisten, hindari kode yang terlalu panjang dalam satu baris, serta pisahkan fungsi berdasarkan tugasnya. Dengan menerapkan prinsip clean code, kode tidak hanya akan berjalan dengan baik, tetapi juga lebih mudah dikelola di masa depan.

Baca Juga : Seputar Nemolab