Beberapa petua untuk membantu menjadikan kod lebih bersih.

Saya akan menggabungkan prinsip daripada "The Clean Coder: A Code of Conduct for Professional Programmer" oleh Robert C. Martin (Uncle Bob). Buku ini menekankan profesionalisme, disiplin dan amalan yang selaras dengan penulisan kod yang bersih, boleh diselenggara dan menjadi jurutera perisian yang berkesan. Di bawah ialah panduan komprehensif yang disemak dan disesuaikan untuk menguasai pembangunan bahagian hadapan dalam 2025, menggabungkan ajaran The Clean Coder:

---

1. Profesionalisme: Pengekodan dengan Disiplin

Intipati The Clean Coder berkisar pada profesionalisme, yang terpakai secara langsung pada cara anda mengekod sebagai pembangun bahagian hadapan.

1.1. Ambil Tanggungjawab untuk Kod Anda

• Miliki Kod: Terima tanggungjawab untuk pepijat, ralat dan keperluan yang terlepas. Jika berlaku kesilapan, betulkan dengan segera dan ambil iktibar daripadanya.
• Minta Kejelasan: Jika keperluan atau reka bentuk tidak jelas, jangan teruskan dengan andaian. Sebaliknya, bekerjasama dengan pihak berkepentingan untuk memastikan penjajaran.

1.2. Tulis Kod yang Anda Banggakan

Amalkan minda tukang. Kod yang anda hantar harus mencerminkan usaha terbaik anda, mengimbangi prestasi, kebolehbacaan dan kebolehselenggaraan.

---

2. Kebolehbacaan Kod: Kod Kraf Seperti Menulis

Pakcik Bob menekankan prinsip: "Kod anda ialah kerajinan anda." Kod hendaklah ditulis supaya orang lain (dan diri anda pada masa hadapan) boleh membaca dan memahaminya dengan mudah.

2.1. Kesederhanaan mengatasi Kepandaian

Elakkan menulis kod yang terlalu pintar atau samar. Kod yang ringkas, jelas dan membosankan selalunya lebih baik daripada kod "pintar" yang mengelirukan rakan sepasukan anda.

Sebaliknya:

const d = (x) => x % 2 ? 'odd' : 'even'; // Confusing intent

Lakukan ini:

const getOddOrEven = (number) => number % 2 === 0 ? 'even' : 'odd';

2.2. Perkara Penamaan

• Nama pembolehubah dan fungsi harus menerangkan dengan jelas tujuannya.
• Gunakan kata kerja untuk fungsi (fetchMovies, calculateTotal) dan kata nama untuk pembolehubah (userList, movieDetails).

2.3. Pastikan Kaedah dan Fungsi Kecil

Fungsi harus melakukan satu perkara dan satu perkara dengan baik. Uncle Bob mengesyorkan mengehadkan fungsi kepada 5-10 baris kod apabila boleh.

Teruk:

function renderMovieCard(movie) {
  // fetch data, format, render JSX in one place
}

Baik:

Pecahkan ini kepada berbilang fungsi, seperti fetchMovieDetails, formatMovieData dan renderMovieCard.

---

3. Pemisahan Kebimbangan (Prinsip Tanggungjawab Tunggal)

Setiap bahagian kod harus mempunyai satu tujuan yang jelas.

3.1. Komponen, Logik dan Gaya

• Komponen: Kendalikan pemaparan/UI sahaja.
• Logik: Bungkus logik boleh guna semula dalam cangkuk tersuai atau utiliti.
• Gaya: Gaya abstrak ke dalam Modul CSS, CSS yang mengutamakan utiliti (cth., Tailwind) atau komponen gaya.

3.2. Contoh: Komponen Diasingkan Bersih

Buruk (Logik, gaya dan pemaparan yang digabungkan dengan ketat):

const d = (x) => x % 2 ? 'odd' : 'even'; // Confusing intent

---

4. Komunikasi: Tulis Kod Dokumentasi Kendiri

Diinspirasikan oleh The Clean Coder, bertujuan untuk kod yang memerlukan dokumentasi luaran yang minimum.

4.1. Kod Harus Bercerita

Setiap baris kod harus mengalir secara logik, seperti membaca buku. Contohnya:

• Syarat abstrak kepada pembolehubah yang dinamakan dengan jelas.
• Gantikan "nombor ajaib" dengan pemalar bernama.

Sebelumnya (Sukar untuk difahami):

const getOddOrEven = (number) => number % 2 === 0 ? 'even' : 'odd';

Selepas (Niat boleh dibaca):

function renderMovieCard(movie) {
  // fetch data, format, render JSX in one place
}

---

5. Pengujian: Jaring Keselamatan Anda

Pengujian ialah tumpuan utama dalam The Clean Coder, menekankan bahawa profesional sentiasa menguji kerja mereka.

5.1. Liputan Ujian

Berusaha untuk sekurang-kurangnya:

• 80% ujian unit liputan.
• Menguji perjalanan pengguna utama dengan ujian penyepaduan atau ujian E2E.

5.2. Tulis Ujian Bermakna

Ujian yang baik menerangkan tingkah laku dan keperluan—bukan butiran pelaksanaan.

Contoh Ujian:

function MovieCard({ movie }) {
  const isBlockbuster = movie.revenue > 1000000;
  return (
    <div>



<p>Good (Separation of concerns):<br>
</p>

<pre class="brush:php;toolbar:false">// hooks/useIsBlockbuster.js
export const useIsBlockbuster = (revenue) => revenue > 1000000;

// components/MovieCard.js
import { useIsBlockbuster } from '../hooks/useIsBlockbuster';
import styles from './MovieCard.module.css';

function MovieCard({ movie }) {
  const isBlockbuster = useIsBlockbuster(movie.revenue);
  return <div classname="{isBlockbuster" styles.blockbuster : styles.movie>{movie.title}</div>;
}

5.3. Ujian Automasi

• Automasikan ujian menggunakan saluran paip CI/CD (cth., GitHub Actions, CircleCI).
• Jalankan ujian prestasi untuk mengenal pasti kesesakan awal.

---

6. Penambahbaikan Berterusan

Pakcik Bob menekankan kepentingan mengamalkan kerajinan anda. Ini terpakai kepada pembangun bahagian hadapan:

6.1. Refactor Tanpa henti

• Lawati semula dan perbaiki kod secara kerap, terutamanya kawasan yang mempunyai hutang teknologi.
• Gunakan Peraturan Pengakap Lelaki: “Tinggalkan pangkalan kod lebih bersih daripada yang anda temui.”

6.2. Ketahui Alat dan Teknik Baharu

• Kekal dikemas kini dengan trend bahagian hadapan moden seperti Komponen Pelayan React, Penedaran Tepi dan UX berbantukan AI.

---

7. Pengurusan Masa dan Fokus

Profesionalisme bermaksud menyampaikan tepat pada masanya tanpa memotong sudut. Ikuti nasihat The Clean Coder untuk menguruskan masa anda dengan berkesan.

7.1. Bekerja dalam Lelaran

Pecahkan ciri kepada penyampaian yang lebih kecil dan berperingkat.

7.2. Elakkan Terlalu Komitmen

Belajar untuk mengatakan "tidak" pada tarikh akhir yang tidak munasabah. Sebaliknya, berunding hasil penghantaran yang mengekalkan kualiti.

---

8. Kemahiran Insaniah: Kerjasama dan Komunikasi

Pengaturcara profesional ialah pemain pasukan. Ini terpakai pada cara anda bekerja dengan pereka bentuk, pengurus produk dan pembangun bahagian belakang.

8.1. Berkomunikasi Awal dan Kerap

• Kongsi kemajuan dengan kerap.
• Tingkatkan penyekat atau cabaran secepat mungkin.

8.2. Ulasan Kod

Terlibat secara aktif dalam ulasan kod rakan sebaya. Gunakannya sebagai peluang untuk pembelajaran dan penambahbaikan.

---

9. Seni Bina Bersih di Frontend

Gunakan Prinsip seni bina The Clean Coder untuk memastikan asas kod anda kekal boleh diselenggara semasa ia berkembang.

9.1. Asingkan UI daripada Pengurusan Negeri

• Gunakan Redux Toolkit atau Zustand untuk keadaan berpusat.
• Kekalkan keadaan setempat (seperti togol modal) dalam komponen, tetapi wakilkan logik keadaan kompleks kepada perpustakaan khusus.

9.2. Gunakan Suntikan Ketergantungan

Lepasi kebergantungan (mis., API atau perkhidmatan) sebagai prop dan bukannya pengekodan kerasnya. Ini meningkatkan kebolehujian.

---

10. Jangan Berhenti Belajar

Intipati The Clean Coder ialah profesionalisme adalah perjalanan, bukan destinasi.

• Buku untuk Meneruskan Penguasaan:
  • "Seni Bina Bersih" oleh Robert C. Martin.
  • "JavaScript: The Good Parts" oleh Douglas Crockford.
  • "Pemfaktoran Semula" oleh Martin Fowler.
• Amalan Tangan: Kerap membina projek sampingan kecil atau menyumbang kepada sumber terbuka.

---

Pemikiran Akhir

Untuk menjadi pembangun hadapan utama pada tahun 2025, adalah penting untuk menerima profesionalisme, prinsip kod yang bersih dan minda penambahbaikan berterusan. Gunakan teknik ini setiap hari, dan dari semasa ke semasa, kod anda akan mencerminkan kecemerlangan teknikal dan ketukangan. Beritahu saya jika anda mahu pecahan projek dunia sebenar menggunakan konsep ini!