Rumah hujung hadapan web tutorial js Apakah Kod Bersih dan Mengapa ia penting

Apakah Kod Bersih dan Mengapa ia penting

Jul 28, 2024 am 07:01 AM

What is Clean Code and Why it is important

Menulis kod yang hanya perlu digunakan sekali boleh dilakukan walau bagaimanapun anda mahu menulis. Tetapi, dalam kebanyakan kes, mematuhi amalan terbaik dan mengekalkan kod bersih adalah penting.

Ingat, kod anda mungkin akan dibaca oleh pembangun lain, atau anda sendiri, pada masa akan datang. Apabila tiba masanya, kod anda harus jelas. Setiap pembolehubah, fungsi dan ulasan hendaklah tepat, bersih dan mudah difahami. Pendekatan ini bukan sahaja memudahkan penyelenggaraan yang lebih mudah tetapi juga menggalakkan kerjasama dan kecekapan dalam pasukan pembangunan anda.

Jadi, apabila seseorang (atau anda) kembali untuk menambah atau mengubah suai kod anda, mudah untuk memahami perkara yang dilakukan oleh setiap baris kod. Jika tidak, kebanyakan masa anda akan dihabiskan hanya untuk cuba memahami kod tersebut. Isu yang sama akan timbul untuk pembangun baharu yang bekerja pada pangkalan kod anda. Mereka tidak akan memahami kod jika ia tidak bersih. Oleh itu, adalah sangat penting untuk menulis kod bersih.

Apakah Kod Bersih?

Kod bersih pada asasnya merujuk kepada kod iaitu

  1. Mudah Difahami
  2. Mudah untuk Nyahpepijat
  3. Mudah Diselenggara
  4. Komen ditulis dengan baik, pendek dan boleh difahami
  5. Tiada kod pendua(Berlebihan) dan mengikut peraturan KISS (Simpan mudah, Bodoh!)

Dengan itu untuk menulis kod bersih pembangun perlu mengekalkan konsistensi dalam kod dan pembangun perlu mengikut amalan terbaik untuk bahasa tertentu.

Mengapa Kod Bersih adalah penting?

Apabila pasukan mengikut prinsip kod yang bersih, pangkalan kod menjadi lebih mudah untuk dibaca dan dinavigasi. Ini membantu pembangun memahami kod dengan cepat dan mula menyumbang. Berikut ialah beberapa sebab mengapa kod bersih penting.

1. Kebolehbacaan dan penyelenggaraan: Kod mudah dibaca dan difahami apabila ia ditulis dengan baik, mempunyai ulasan yang baik dan mengikut amalan terbaik. Sebaik sahaja isu atau pepijat datang, anda tahu di mana untuk mencarinya.

2. Penyahpepijatan: Kod bersih direka bentuk dengan kejelasan dan kesederhanaan, menjadikannya lebih mudah untuk mencari dan memahami bahagian tertentu pangkalan kod. Struktur yang jelas, nama pembolehubah yang bermakna dan fungsi yang jelas menjadikannya lebih mudah untuk mengenal pasti dan menyelesaikan isu.

3. Kualiti dan kebolehpercayaan yang dipertingkatkan: Kod bersih mengikut amalan terbaik bahasa tertentu dan mengutamakan kod berstruktur dengan baik. Ia menambah kualiti dan meningkatkan kebolehpercayaan. Jadi ia menghapuskan ralat yang mungkin disebabkan oleh kereta dan kod tidak berstruktur.

Sekarang kami memahami sebab kod bersih adalah penting, mari kita selami beberapa amalan dan prinsip terbaik untuk membantu anda menulis kod bersih.


Prinsip Kod Bersih

Untuk mencipta kod yang hebat, seseorang mesti mematuhi prinsip dan amalan kod bersih, seperti menggunakan kaedah yang kecil dan jelas.

Jom lihat ini secara terperinci.

1. Elakkan Nombor Berkod Keras

Daripada menggunakan nilai secara langsung, kita boleh menggunakan pemalar dan memberikan nilai itu kepadanya. Supaya pada masa hadapan jika kita perlu mengemas kini nilai itu kita perlu mengemas kininya di satu lokasi sahaja.

Contoh

function getDate() {
  const date = new Date();
  return "Today's date: " + date;
}

function getFormattedDate() {
  const date = new Date().toLocaleString();
  return "Today's date: " + date;
}
Salin selepas log masuk

Dalam kod ini, pada satu ketika terdapat perubahan yang bukannya "Tarikh hari ini: " perlu menjadi "Tarikh: ". Ini boleh diperbaiki dengan memberikan rentetan itu kepada satu pembolehubah.

Kod yang dipertingkatkan:

const todaysDateLabel = "Today's date: ";

function getDate() {
  const date = new Date();
  return todaysDateLabel + date;
}

function getFormattedDate() {
  const date = new Date().toLocaleString();
  return todaysDateLabel + date;
}
Salin selepas log masuk

Dalam kod di atas menjadi mudah untuk menukar rentetan tarikh apabila diperlukan. Ia meningkatkan kebolehselenggaraan.

2. Gunakan Nama Bermakna dan Deskriptif
Daripada menggunakan nama pembolehubah biasa di mana-mana, kita boleh menggunakan lebih sedikit nama deskriptif yang menerangkan sendiri. Nama pembolehubah itu sendiri harus menentukan penggunaannya.

Peraturan nama

  1. Pilih nama deskriptif dan tidak jelas.
  2. Buat perbezaan yang bermakna.
  3. Gunakan nama yang boleh disebut.
  4. Gunakan nama yang boleh dicari.
  5. Gantikan nombor ajaib dengan pemalar bernama.
  6. Elakkan pengekodan. Jangan tambahkan awalan atau taip maklumat.

Contoh

// Calculate the area of a rectangle
function calc(w, h) {
    return w * h;
}

const w = 5;
const h = 10;
const a = calc(w, h);
console.log(`Area: ${a}`);
Salin selepas log masuk

Di sini kod adalah betul tetapi terdapat beberapa kekaburan dalam kod. Mari lihat kod di mana nama deskriptif digunakan.

Kod yang dipertingkatkan

// Calculate the area of a rectangle
function calculateRectangleArea(width, height) {
    return width * height;
}

const rectangleWidth = 5;
const rectangleHeight = 10;
const area = calculateRectangleArea(rectangleWidth, rectangleHeight);
console.log(`Area of the rectangle: ${area}`);
Salin selepas log masuk

Di sini setiap nama pembolehubah adalah penjelasan sendiri. Jadi, ia adalah mudah untuk memahami kod dan ia meningkatkan kualiti kod.

3. Hanya gunakan komen di mana perlu
Anda tidak perlu menulis komen di mana-mana. Tulis sahaja di mana perlu dan tulis dengan ringkas dan mudah difahami. Terlalu banyak komen akan membawa kepada kekeliruan dan pangkalan kod yang tidak kemas.

Peraturan ulasan

  1. Always try to explain yourself in code.
  2. Don't be redundant.
  3. Don't add obvious noise.
  4. Don't use closing brace comments.
  5. Don't comment out code. Just remove.
  6. Use as explanation of intent.
  7. Use as clarification of code.
  8. Use as warning of consequences.

Example

// Function to get the square of a number
function square(n) {
    // Multiply the number by itself
    var result = n * n; // Calculate square
    // Return the result
    return result; // Done
}

var num = 4; // Number to square
var squared = square(num); // Call function

// Output the result
console.log(squared); // Print squared number

Salin selepas log masuk

Here we can see comments are used to define steps which be easily understand by reading the code. This comments are unnecessary and making code cluttered. Let's see correct use of comments.

Improved code

/**
 * Returns the square of a number.
 * @param {number} n - The number to be squared.
 * @return {number} The square of the input number.
 */
function square(n) {
    return n * n;
}

var num = 4;
var squared = square(num); // Get the square of num

console.log(squared); // Output the result

Salin selepas log masuk

In above example comments are used only where it is needed. This is good practice to make your code clean.

4. Write Functions That Do Only One Thing
When you write functions, don't add too many responsibilities to them. Follow the Single Responsibility Principle (SRP). This makes the function easier to understand and simplifies writing unit tests for it.

Functions rules

  1. Keep it Small.
  2. Do one thing.
  3. Use descriptive names.
  4. Prefer fewer arguments.
  5. Split method into several independent methods that can be called from the client.

Example

async function fetchDataAndProcess(url) {
    // Fetches data from an API and processes it in the same function
    try {
        const response = await fetch(url);
        const data = await response.json();

        // Process data (e.g., filter items with value greater than 10)
        const processedData = data.filter(item => item.value > 10);

        console.log(processedData);
    } catch (error) {
        console.error('Error:', error);
    }
}

// Usage
const apiUrl = 'https://api.example.com/data';
fetchDataAndProcess(apiUrl);

Salin selepas log masuk

In the above example, we can see a function that fetches data using an API and processes it. This can be done by another function. Currently, the data processing function is very small, but in a production-level project, data processing can be very complex. At that time, it is not a good practice to keep this in the same function. This will make your code complex and hard to understand in one go.
Let's see the clean version of this.

Improved code

async function fetchData(url) {
    // Fetches data from an API
    try {
        const response = await fetch(url);
        return await response.json();
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

function processData(data) {
    // Processes the fetched data (e.g., filter items with value greater than 10)
    return data.filter(item => item.value > 10);
}

// Usage
const apiUrl = 'https://api.example.com/data';

fetchData(apiUrl)
    .then(data => {
        const processedData = processData(data);
        console.log(processedData);
    })
    .catch(error => {
        console.error('Error:', error);
    });

Salin selepas log masuk

In the this example, the responsibilities are separated: the fetchData function handles the API call, and the processData function handles data processing. This makes the code easier to understand, maintain, and test.

5. Avoid Code Duplication (Follow DRY Principle - Don't Repeat Your Self)

To enhance code maintainability and cleanliness, strive to create reusable functions or reuse existing code whenever possible. For instance, if you are fetching data from an API to display on a page, you would write a function that retrieves the data and passes it to a renderer for UI display. If the same data needs to be shown on another page, instead of writing the same function again, you should move the function to a utility file. This allows you to import and use the function in both instances, promoting reusability and consistency across your codebase.

Other General Rules for writing Clean Code

  • Follow standard conventions(For JavaScript Camel Case).
  • Keep it simple stupid. Simpler is always better. Reduce complexity as much as possible.
  • Boy scout rule. Leave the campground cleaner than you found it.
  • Always find root cause. Always look for the root cause of a problem.
  • Write code which is easy to understand

Implement this Practices and Principles from today to write Clean Code.

Atas ialah kandungan terperinci Apakah Kod Bersih dan Mengapa ia penting. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Kenyataan Laman Web ini
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn

Alat AI Hot

Undresser.AI Undress

Undresser.AI Undress

Apl berkuasa AI untuk mencipta foto bogel yang realistik

AI Clothes Remover

AI Clothes Remover

Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.

Undress AI Tool

Undress AI Tool

Gambar buka pakaian secara percuma

Clothoff.io

Clothoff.io

Penyingkiran pakaian AI

Video Face Swap

Video Face Swap

Tukar muka dalam mana-mana video dengan mudah menggunakan alat tukar muka AI percuma kami!

Artikel Panas

<🎜>: Bubble Gum Simulator Infinity - Cara Mendapatkan dan Menggunakan Kekunci Diraja
3 minggu yang lalu By 尊渡假赌尊渡假赌尊渡假赌
Mandragora: Whispers of the Witch Tree - Cara Membuka Kunci Cangkuk Bergelut
3 minggu yang lalu By 尊渡假赌尊渡假赌尊渡假赌
Nordhold: Sistem Fusion, dijelaskan
3 minggu yang lalu By 尊渡假赌尊渡假赌尊渡假赌

Alat panas

Notepad++7.3.1

Notepad++7.3.1

Editor kod yang mudah digunakan dan percuma

SublimeText3 versi Cina

SublimeText3 versi Cina

Versi Cina, sangat mudah digunakan

Hantar Studio 13.0.1

Hantar Studio 13.0.1

Persekitaran pembangunan bersepadu PHP yang berkuasa

Dreamweaver CS6

Dreamweaver CS6

Alat pembangunan web visual

SublimeText3 versi Mac

SublimeText3 versi Mac

Perisian penyuntingan kod peringkat Tuhan (SublimeText3)

Topik panas

Tutorial Java
1668
14
Tutorial PHP
1273
29
Tutorial C#
1255
24
Enjin JavaScript: Membandingkan Pelaksanaan Enjin JavaScript: Membandingkan Pelaksanaan Apr 13, 2025 am 12:05 AM

Enjin JavaScript yang berbeza mempunyai kesan yang berbeza apabila menguraikan dan melaksanakan kod JavaScript, kerana prinsip pelaksanaan dan strategi pengoptimuman setiap enjin berbeza. 1. Analisis leksikal: Menukar kod sumber ke dalam unit leksikal. 2. Analisis Tatabahasa: Menjana pokok sintaks abstrak. 3. Pengoptimuman dan Penyusunan: Menjana kod mesin melalui pengkompil JIT. 4. Jalankan: Jalankan kod mesin. Enjin V8 mengoptimumkan melalui kompilasi segera dan kelas tersembunyi, Spidermonkey menggunakan sistem kesimpulan jenis, menghasilkan prestasi prestasi yang berbeza pada kod yang sama.

Python vs JavaScript: Keluk Pembelajaran dan Kemudahan Penggunaan Python vs JavaScript: Keluk Pembelajaran dan Kemudahan Penggunaan Apr 16, 2025 am 12:12 AM

Python lebih sesuai untuk pemula, dengan lengkung pembelajaran yang lancar dan sintaks ringkas; JavaScript sesuai untuk pembangunan front-end, dengan lengkung pembelajaran yang curam dan sintaks yang fleksibel. 1. Sintaks Python adalah intuitif dan sesuai untuk sains data dan pembangunan back-end. 2. JavaScript adalah fleksibel dan digunakan secara meluas dalam pengaturcaraan depan dan pelayan.

Dari C/C ke JavaScript: Bagaimana semuanya berfungsi Dari C/C ke JavaScript: Bagaimana semuanya berfungsi Apr 14, 2025 am 12:05 AM

Peralihan dari C/C ke JavaScript memerlukan menyesuaikan diri dengan menaip dinamik, pengumpulan sampah dan pengaturcaraan asynchronous. 1) C/C adalah bahasa yang ditaip secara statik yang memerlukan pengurusan memori manual, manakala JavaScript ditaip secara dinamik dan pengumpulan sampah diproses secara automatik. 2) C/C perlu dikumpulkan ke dalam kod mesin, manakala JavaScript adalah bahasa yang ditafsirkan. 3) JavaScript memperkenalkan konsep seperti penutupan, rantaian prototaip dan janji, yang meningkatkan keupayaan pengaturcaraan fleksibiliti dan asynchronous.

JavaScript dan Web: Fungsi teras dan kes penggunaan JavaScript dan Web: Fungsi teras dan kes penggunaan Apr 18, 2025 am 12:19 AM

Penggunaan utama JavaScript dalam pembangunan web termasuk interaksi klien, pengesahan bentuk dan komunikasi tak segerak. 1) kemas kini kandungan dinamik dan interaksi pengguna melalui operasi DOM; 2) pengesahan pelanggan dijalankan sebelum pengguna mengemukakan data untuk meningkatkan pengalaman pengguna; 3) Komunikasi yang tidak bersesuaian dengan pelayan dicapai melalui teknologi Ajax.

JavaScript in Action: Contoh dan projek dunia nyata JavaScript in Action: Contoh dan projek dunia nyata Apr 19, 2025 am 12:13 AM

Aplikasi JavaScript di dunia nyata termasuk pembangunan depan dan back-end. 1) Memaparkan aplikasi front-end dengan membina aplikasi senarai TODO, yang melibatkan operasi DOM dan pemprosesan acara. 2) Membina Restfulapi melalui Node.js dan menyatakan untuk menunjukkan aplikasi back-end.

Memahami Enjin JavaScript: Butiran Pelaksanaan Memahami Enjin JavaScript: Butiran Pelaksanaan Apr 17, 2025 am 12:05 AM

Memahami bagaimana enjin JavaScript berfungsi secara dalaman adalah penting kepada pemaju kerana ia membantu menulis kod yang lebih cekap dan memahami kesesakan prestasi dan strategi pengoptimuman. 1) aliran kerja enjin termasuk tiga peringkat: parsing, penyusun dan pelaksanaan; 2) Semasa proses pelaksanaan, enjin akan melakukan pengoptimuman dinamik, seperti cache dalam talian dan kelas tersembunyi; 3) Amalan terbaik termasuk mengelakkan pembolehubah global, mengoptimumkan gelung, menggunakan const dan membiarkan, dan mengelakkan penggunaan penutupan yang berlebihan.

Python vs JavaScript: Komuniti, Perpustakaan, dan Sumber Python vs JavaScript: Komuniti, Perpustakaan, dan Sumber Apr 15, 2025 am 12:16 AM

Python dan JavaScript mempunyai kelebihan dan kekurangan mereka sendiri dari segi komuniti, perpustakaan dan sumber. 1) Komuniti Python mesra dan sesuai untuk pemula, tetapi sumber pembangunan depan tidak kaya dengan JavaScript. 2) Python berkuasa dalam bidang sains data dan perpustakaan pembelajaran mesin, sementara JavaScript lebih baik dalam perpustakaan pembangunan dan kerangka pembangunan depan. 3) Kedua -duanya mempunyai sumber pembelajaran yang kaya, tetapi Python sesuai untuk memulakan dengan dokumen rasmi, sementara JavaScript lebih baik dengan MDNWebDocs. Pilihan harus berdasarkan keperluan projek dan kepentingan peribadi.

Python vs JavaScript: Persekitaran dan Alat Pembangunan Python vs JavaScript: Persekitaran dan Alat Pembangunan Apr 26, 2025 am 12:09 AM

Kedua -dua pilihan Python dan JavaScript dalam persekitaran pembangunan adalah penting. 1) Persekitaran pembangunan Python termasuk Pycharm, Jupyternotebook dan Anaconda, yang sesuai untuk sains data dan prototaip cepat. 2) Persekitaran pembangunan JavaScript termasuk node.js, vscode dan webpack, yang sesuai untuk pembangunan front-end dan back-end. Memilih alat yang betul mengikut keperluan projek dapat meningkatkan kecekapan pembangunan dan kadar kejayaan projek.

See all articles