JSON Toolkit

Array dan objek JSON: struktur dan sarangan untuk pemula

Inti pati: JSON hanya punya dua wadah: objek untuk medan bernama, array untuk senarai berurutan. Belajar menggabungkannya, memilih yang tepat, dan membetulkan tiga ralat paling kerap — array palsu dengan kunci nombor, koma di hujung dan tanda petik tunggal.

Pemula~6 min bacaanDiterbitkan 2026-11-20Dikemas kini 2026-11-20
Muka depan pengenalan kepada struktur array dan objek JSON

JSON hanya memberi anda dua wadah: objek membawa medan bernama, array membawa senarai berurutan — dan hampir setiap payload rosak dijelaskan oleh tanda petik, koma, atau senarai yang ditulis sebagai objek palsu.

Satu: JSON hanya ada dua wadah

Sekalir komplex mana pun respons API, semuanya berkurang kepada dua wadah dan enam jenis nilai. Objek ialah koleksi pasangan kunci/nilai dalam kurungan bahu {}; array ialah senarai berurutan nilai dalam kurungan segi empat []. Nilai boleh berupa rentetan, nombor, true, false, null — atau sekali lagi objek atau array. Objek dalam array, array dalam objek: rekursi inilah keseluruhan kuasa ekspresif JSON.

{
  "user": { "name": "Ada", "active": true },
  "roles": ["admin", "editor"],
  "lastLogin": null,
  "loginCount": 42
}

Daripada situ timbul kesan praktikal: menghadapi payload yang mengelirukan, jangan baca aksara demi aksara. Periksa dahulu aksara paling luar sama ada { atau [. Jika objek, bacanya sebagai medan bernama; jika array, bacanya sebagai senarai, kemudian turun tahap demi tahap. Rajah sintaks di json.org muat dalam satu halaman tepat kerana dua struktur tambah rekursi meliputi segalanya.

Dua: menulis objek, empat peraturan keras

Objek ialah tempat pemula paling banyak silap, tetapi peraturannya berkurang kepada empat:

  1. Kunci mesti rentetan dalam petikan berkembar. {name: "Ada"} dan {'name': 'Ada'} kedua-duanya tidak sah; mesti ditulis {"name": "Ada"}. Literal objek JavaScript membenarkan kunci bogang dan petik tunggal, JSON tidak — inilah kekeliruan paling biasa antara keduanya.
  2. Asingkan pasangan dengan koma dan jangan tinggalkan koma selepas pasangan terakhir. {"a": 1, "b": 2,} gagal dengan Unexpected token } di kurungan bahu penutup.
  3. Kunci sepatutnya unik. RFC 8259 merumuskannya sebagai SHOULD, bukan MUST: kunci berulang tidak menyebabkan ralat, tetapi nilai pertama atau terakhir yang kekal bergantung pada pelaksanaan, dan bahasa-bahasa berbeza. Jangan sesekali bergantung padanya.
  4. Susunan kunci tidak bermakna. {"a":1,"b":2} dan {"b":2,"a":1} ialah objek yang sama; alat diff dan fungsi perbandingan mengabaikan susunan kunci. Jika susunan penting, data itu milik array.

Tiga: menulis array, susunan itu sendiri ialah data

Array menyimpan nilai mengikut kedudukan dan pengindeksan bermula pada 0: dalam ["admin", "editor"], rentetan "editor" ialah [1]. Susunan ini bermakna — inilah perbezaan utama antara array dan objek. Hasil carian tersusun mengikut relevans, entri log tersusun mengikut tarikh: maklumat ini hanya hidup dalam jujukan, dan penukaran kepada objek memusnahkannya.

Dua cadangan praktikal. Pertama, pastikan elemen homogen: [{"id":1},{"id":2}] jauh lebih mudah diambil berbanding [1, "text", true] — sah tetapi memaksa setiap pengguna menguji jenis di setiap langkah. Kedua, array kosong [] ialah nilai yang sah sepenuhnya — bila medan senarai belum ada kandungan, hasilkan [] dan bukan null, supaya pengguna tidak perlu menguji kewujudan lalu kekosongan.

[
  { "city": "Tokyo", "population": 13960000 },
  { "city": "Delhi", "population": 16780000 }
]

Empat: sarangan, empat bentuk payload sebenar

Data sebenar hanyalah dua wadah ini disarang satu sama lain, dan polanya berkurang kepada empat bentuk:

Bentuk Rupa Penggunaan lazim
Objek mengandungi array {"tags": ["a","b"]} Medan senarai sesebuah entiti
Array objek [{"id":1},{"id":2}] Senarai rekod, hasil berhalaman
Objek mengandungi objek {"db": {"host": "..."}} Konfigurasi berkelompok, blok alamat
Array array [[1,2],[3,4]] Matriks, baris jadual

Respons API lazim memakai objek sebagai kulit dan array sebagai kandungan:

{
  "code": 0,
  "data": {
    "items": [
      { "id": 1, "title": "first" },
      { "id": 2, "title": "second" }
    ],
    "page": 1,
    "total": 2
  }
}

Jangan sarang demi sarang. Melebihi tiga atau empat tahap, laluan akses menjadi tidak boleh dibaca dan kod pengguna membengkak secara selari. Medan yang sentiasa merentas bersama patut dalam subobjek: gantikan addrCity dan addrZip dengan address: {city, zip}.

Lima: objek atau array, jadual keputusan

Soalan Jawapan Sebab
Setiap nilai ada nama? Objek Akses melalui kunci; menambah atau membuang medan tidak merosakkan apa-apa
Senarai rekod seakan-akan? Array Susunan penting; boleh map dan filter
Perlu carian pantas melalui kunci? Objek terindeks dengan pengenal Akses O(1) alih-alih imbasan
Beberapa atribut entiti yang sama? Objek Atribut tiada susunan tersendiri
Koleksi berkembang elemen seakan-akan? Array Panjang mengembang bebas

Satu antipola patut disebut khusus: meniru array dengan objek berkunci "0", "1", "2". Ia dihurai tanpa ralat, tetapi anda kehilangan semantik panjang dan alat lelaran array sebenar, dan pengguna terpaksa menyusun Object.keys sebelum membaca apa-apa. Jika kuncinya nombor berurutan, tulis array sebenar. Sebaliknya juga benar: senarai pasangan kunci/nilai seperti [{"key":"theme","value":"dark"}] lebih rendah daripada objek {"theme": "dark"} — melainkan kuncinya benar-benar dinamik dan tidak boleh diisytiharkan awal-awal.

Enam: tiga ralat kerap dan mesejnya

Bentuk salah Ralat lazim Pembetulan
Koma di hujung {"a":1,} Unexpected token } Buang koma terakhir
Petik tunggal / kunci bogang {name:'Ada'} Unexpected token ' / Expected property name Petik berkembar untuk kunci dan rentetan, sentiasa
Literal Python True / None Unexpected token T Ganti dengan true / null
Array palsu berkunci nombor Tiada ralat, semantik salah Tulis semula sebagai array sebenar

Dua tabiat penyahpepijatan: penghurai biasanya melaporkan kedudukan selepas aksara bersalah, jadi bila nampak position 42, lihat satu atau dua aksara ke belakang; dan JSON gergasi satu baris patut diformat dahulu — nombor baris dan lajur sentiasa menewaskan offset aksara. Katalog ralat penuh ada dalam jadual rujukan ralat JSON, dan alur penapisan langkah demi langkah dalam cara membetulkan ralat parse JSON.

Tujuh: selepas menulis, sahkan struktur

JSON tulisan tangan harus sentiasa melalui penghurai sebelum diserahkan. Semakan paling ringan cukup dalam satu baris arahan:

python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK

Dalam talian, tampal kandungan di halaman pemformat dan pengesah JSON — ralat sintaks pulang dengan baris dan lajur. Tukar ke paparan pepohon untuk melihat jenis setiap tahap sekali imbas: adakah sesuatu nombor ditafsir sebagai rentetan, adakah panjang array sepadan. Dan apabila pembaca bukan teknikal, payload array-objek boleh dibentangkan sebagai baris dan lajur di halaman JSON ke jadual — sekali gus mengesahkan data anda benar-benar senarai rekod yang kemas.

Soalan tentang medan yang sepatutnya array, atau tentang membina semula sarangan yang terlalu dalam, adalah perkara pemodelan jenis — bacaan seterusnya: enam jenis, ketepatan nombor dan jerat enkodan.

Bolehkah array dan objek JSON ditukar antara satu sama lain?

Boleh, tetapi bukan tanpa kehilangan. Menukar objek kepada array lazimnya bermaksud menukar kunci kepada nilai dan kehilangan akses melalui kunci; menukar array kepada objek menuntut penciptaan kunci bagi setiap elemen, dan asalan kunci itu sendiri ialah masalah reka bentuk baharu. Tentukan mengikut cara pengguna membaca data, bukan mengikut keselesaan sintaks.

Bolehkah kunci objek berulang?

Sintaksnya boleh — RFC 8259 hanya kata kunci SEBAIKNYA unik. Namun JavaScript menyimpan nilai terakhir sedangkan sesetengah pustaka keluarga C menyimpan nilai pertama: kelakuan berbeza antara penghurai. Dalam tandatangan, diff atau cincang, kunci berulang mencetuskan ketidakpadanan terus. Elakkan di sisi pengeluar dan anggap ulangan dari sumber tak dikenali sebagai risiko di sisi pengguna.

Bolehkah array mengandungi nilai pelbagai jenis?

Sintaksnya boleh: [1, "a", true] ialah JSON sah. Tetapi array tak homogen memaksa pengguna menguji jenis di setiap kedudukan dan sukar dinyatakan dalam skema. Kecuali matriks dan tuple — di mana kedudukan itulah semantiknya — pastikan array homogen.

Mengapa {name:'json'} gagal pengesahan?

Kerana JSON menuntut petikan berkembar mengelilingi setiap kunci dan setiap nilai rentetan. {name:'json'} ialah literal objek JavaScript, bukan JSON. Gantikan dengan {"name": "json"} dan pengesahan akan lulus. Petik tunggal, kunci bogang dan komen milik dialek seperti JSON5/JSONC yang menuntut penghurai sendiri alih-alih JSON.parse piawai.