Kod Yang Dimiliki di Muzium, Bukan Repositori

"Mengapa Kita Tidak Harus Meraikan Kod Cantik"

Kita semua telah melihatnya—kodnya sangat rumit dan murni dalam strukturnya sehinggakan ia berada dalam muzium, bukan repositori. Ia adalah jenis kod yang anda tatap dengan kagum seketika... sehingga anda sedar anda perlu menyahpepijatnya. Kemudian, seperti kita yang lain, anda tertanya-tanya mengapa seseorang memutuskan untuk menulis JavaScript seolah-olah mereka sedang menulis novel Amerika yang hebat seterusnya.

Mari kita lakukan sesuatu yang lurus: kod cantik hanya cantik jika ia berguna. Jika pasukan anda memerlukan Ph.D. dalam Sintaks Esoterik untuk mengetahui cara ciri berfungsi, tahniah—anda telah mencipta karya agung yang tidak akan dikekalkan oleh sesiapa pun.

Inilah sebabnya anda harus menahan keinginan untuk mencipta kod yang terlalu pintar dan perkara yang perlu dilakukan. Ikat pinggang; contoh akan datang.

Pesona Keanggunan Terlalu Kejuruteraan

Mula-mula, mari kita periksa sebab pembangun menulis kod jenis ini.

• Sedap rasanya. Menulis kod yang bijak mencalarkan kegatalan intelektual. Ini adalah detik yang fleksibel, "lihat apa yang boleh saya lakukan".
• Ia menarik perhatian (sesetengah) orang. Sehingga orang yang sama ditugaskan untuk mengekalkannya. Kemudian, ia hanya mengecewakan mereka.
• Ia menunjukkan penguasaan. Atau sekurang-kurangnya ia sepatutnya. Tetapi penguasaan sebenar bukanlah tentang mewujudkan kerumitan; ia mengenai menyelesaikan masalah dengan mudah.

Contoh 1: Fungsi Kilang “WTF”

Inilah permata yang saya temui baru-baru ini:

const createMultiplier = (x) => (y) => (z) => x * y * z;
const multiply = createMultiplier(2)(3);
console.log(multiply(4)); // Outputs 24

Cantik? pasti. Tetapi semoga berjaya kepada pembangun junior yang perlu memikirkan apa yang berlaku di sini. Tiga lapisan fungsi untuk mendarab tiga nombor? Tahniah, anda telah menukar aritmetik kepada acara Olimpik.

Jangan lakukan ini. Berikut ialah fungsi yang sama yang ditulis untuk manusia:

function multiplyThreeNumbers(x, y, z) {
  return x * y * z;
}
console.log(multiplyThreeNumbers(2, 3, 4)); // Outputs 24

Boleh dibaca. Mudah. Mengekalkan kewarasan semua orang.

Contoh 2: The Shakespearean Promise Chain

Sekarang mari kita bercakap tentang rantai janji yang kelihatan seperti ditulis hantu oleh Shakespeare:

fetch(url)
  .then((response) => response.json())
  .then((data) =>
    data.map((item) =>
      item.isActive
        ? { ...item, status: "active" }
        : { ...item, status: "inactive" }
    )
  )
  .then((updatedData) =>
    updatedData.reduce(
      (acc, curr) =>
        curr.status === "active"
          ? { ...acc, active: [...acc.active, curr] }
          : { ...acc, inactive: [...acc.inactive, curr] },
      { active: [], inactive: [] }
    )
  )
  .then((finalResult) => console.log(finalResult))
  .catch((error) => console.error(error));

Kod ini berfungsi. Tetapi ia juga jenayah terhadap sesiapa sahaja yang perlu mengekalkannya. Mengapakah setiap langkah transformasi data bersarang di dalam yang seterusnya seperti anak patung Rusia?

Mari kita refactor:

async function processData(url) {
  try {
    const response = await fetch(url);
    const data = await response.json();

    const updatedData = data.map((item) => ({
      ...item,
      status: item.isActive ? "active" : "inactive",
    }));

    const finalResult = updatedData.reduce(
      (acc, curr) => {
        if (curr.status === "active") {
          acc.active.push(curr);
        } else {
          acc.inactive.push(curr);
        }
        return acc;
      },
      { active: [], inactive: [] }
    );

    console.log(finalResult);
  } catch (error) {
    console.error(error);
  }
}
processData(url);

Memecahkan logik kepada langkah-langkah menjadikan kod itu boleh dibaca. Ia masih melakukan perkara yang sama, tetapi kini jelas perkara yang berlaku pada setiap peringkat.

Mengapa Mudah Adalah Lebih Baik

Mengenai perisian, ingat peraturan emas ini: kod anda bukan diari peribadi. Ia adalah alat komunikasi. Jika pasukan anda tidak dapat membacanya, mereka tidak boleh bekerja dengannya. Dan jika mereka tidak dapat bekerja dengannya, perniagaan tidak boleh bergerak ke hadapan.

Ini sebab kesederhanaan menang:

1 Penyertaan Lebih Cepat: Pembangun remaja tidak sepatutnya memerlukan Batu Rosetta untuk memahami kod anda.
2 Penyahpepijatan Lebih Mudah: Apabila pepijat timbul (dan ia akan berlaku), logik yang jelas menjadikannya lebih mudah untuk ditentukan.
3 Pasukan yang Lebih Bahagia: Tiada siapa yang suka berasa bodoh. Kod yang terlalu pintar akan mengasingkan rakan sepasukan anda.

Ambil Ambil

Tulis kod seperti anda menerangkannya kepada diri masa depan anda selepas tidur yang sukar. Berbaik sangka kepada pembangun seterusnya yang perlu membaca karya anda—kerana kemungkinan besar, pembangun itu ialah anda.

Kod yang cantik bukan tentang betapa mewahnya ia kelihatan; ia mengenai sejauh mana ia menyelesaikan masalah dengan berkesan. Apa-apa yang kurang hanyalah latihan dalam kesombongan.

Atas ialah kandungan terperinci Kod Yang Dimiliki di Muzium, Bukan Repositori. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!