JSON 陣列和物件怎麼寫:結構與巢狀入門
結論:把 JSON 僅有的兩種容器一次講清:物件管欄位、陣列管列表,巢狀怎麼組合、什麼時候用哪個,以及數字鍵偽陣列、尾逗號、單引號三類高頻錯誤的修法。

JSON 只給你兩種容器:物件負責「有名字的欄位」,陣列負責「按順序排列的列表」——寫不對的九成問題出在引號、逗號,以及把列表寫成了偽物件。
一、JSON 只有兩種容器
不管介面回傳的資料有多複雜,拆到最後只有兩種容器和六種值。物件(object)是一組「鍵值對」,用花括號 {} 包起來;陣列(array)是一串按順序排列的值,用方括號 [] 包起來。值可以是字串、數字、true/false、null,也可以再巢狀物件或陣列——物件套陣列、陣列套物件,就這樣組合出所有真實資料。
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
這個認知很實用:遇到看不懂的 JSON,不要從第一個字元往下讀,先找最外層是 { 還是 [。是物件,就按欄位理解;是陣列,就按列表理解,再逐層往裡拆。json.org 的語法圖一共只有一頁,原因正是如此:兩種結構加上遞迴巢狀,表達能力就夠用了。
二、物件的寫法:四條硬規則
物件是新手出錯最密集的地方,規則其實只有四條:
- 鍵必須是雙引號字串。
{name: "Ada"}、{'name': 'Ada'}都不合法,必須是{"name": "Ada"}。JavaScript 物件字面量允許裸鍵和單引號,但 JSON 不允許——這是兩者最常見的混淆點。 - 鍵值對之間用逗號分隔,最後一個後面不能有逗號。
{"a": 1, "b": 2,}會在右花括號處報Unexpected token }。 - 鍵應當唯一。RFC 8259 用的是 SHOULD 而不是 MUST,重複鍵不報錯,但取第一個還是最後一個由解析器決定,不同語言結果可能不同,不能依賴。
- 鍵的順序沒有語義。
{"a":1,"b":2}和{"b":2,"a":1}是同一個物件,diff 工具和比較函式都會忽略鍵序;需要順序的資料應該放進陣列。
三、陣列的寫法:順序本身就是資料
陣列按位置存值,索引從 0 開始:["admin", "editor"] 裡 "editor" 是 [1]。「順序有意義」是陣列和物件最本質的差別——搜尋結果按相關度排序、操作日誌按時間排序,這些資訊只存在於順序裡,換成物件就丟了。
兩個實用建議:一是陣列元素盡量同構,[{"id":1},{"id":2}] 遠比 [1, "text", true] 好處理,後者合法但每一步消費程式碼都要做型別分支;二是空陣列 [] 是完全合法的值,欄位暫時沒有內容時用 [] 而不是 null,消費者就不用先判斷有沒有、再判斷是不是空。
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
四、巢狀:真實介面的四種形狀
真實資料都是兩種容器互相巢狀,模式基本就四種:
| 形狀 | 長相 | 典型場景 |
|---|---|---|
| 物件套陣列 | {"tags": ["a","b"]} |
實體的列表欄位 |
| 陣列套物件 | [{"id":1},{"id":2}] |
記錄列表、分頁結果 |
| 物件套物件 | {"db": {"host": "..."}} |
分組設定、地址資訊 |
| 陣列套陣列 | [[1,2],[3,4]] |
矩陣、表格列 |
典型的 API 回應通常是「物件做外殼、陣列做內容」:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
巢狀別為了深而深:三四層以後,取值路徑長得沒法讀,消費端程式碼也跟著膨脹。總是同時出現的欄位應該收進一個子物件,比如把 addrCity、addrZip 換成 address: {city, zip}。
五、用物件還是陣列:一張決策表
| 問題 | 答案 | 原因 |
|---|---|---|
| 每個值都有名字嗎 | 物件 | 靠鍵取值,增刪欄位不破壞結構 |
| 是一串同類記錄嗎 | 陣列 | 順序有意義,可以 map/filter |
| 要按鍵快速查找嗎 | 鍵做索引的物件 | O(1) 直取,不用遍歷 |
| 是同一個實體的幾項屬性 | 物件 | 屬性之間沒有順序 |
| 是會增刪的同質條目 | 陣列 | 長度自由伸縮 |
特別要提一個反模式:用 "0"、"1"、"2" 這種連續數字鍵的物件冒充陣列。它不報錯,但丟掉了陣列的長度語義和遍歷方法,消費端要額外把 Object.keys 排序再取值。鍵如果是連續編號,直接寫成陣列。反過來,「鍵值對列表」(如 [{"key":"theme","value":"dark"}])也不如物件 {"theme": "dark"},除非鍵本身動態、沒法預先宣告。
六、三類高頻錯誤與報錯對照
| 錯誤寫法 | 典型報錯 | 修法 |
|---|---|---|
尾逗號 {"a":1,} |
Unexpected token } |
刪掉最後一個逗號 |
單引號/裸鍵 {name:'Ada'} |
Unexpected token ' / Expected property name |
鍵和字串一律雙引號 |
Python 字面量 True/None |
Unexpected token T |
改成 true/null |
| 數字鍵偽陣列 | 不報錯,語義錯 | 改成真陣列 |
兩個定位技巧:解析器報錯的位置通常在錯誤字元之後,看到 position 42 要往回看一兩個字元;單行大 JSON 建議先用格式化工具換行再定位,行列號比字元偏移直觀得多。完整的報錯反查可以看JSON 報錯資訊反查表,逐條排查流程在JSON 解析報錯怎麼修。
七、寫完之後:把結構核一遍
手寫的 JSON 一定要過一遍解析器再交付。最輕量的驗證是命令列:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
線上側把內容貼進 JSON 解析格式化 頁,語法錯誤會給出行列級定位;切到樹形檢視能直觀看到每一層的型別——數字有沒有被當成字串、陣列長度對不對,一眼可見。如果要給業務方看,陣列套物件的結構可以直接在 JSON 轉表格 頁展開成行列,順便驗證「這份資料是不是規整的記錄列表」。
結構層面的疑問(哪個欄位該是陣列、巢狀深了怎麼重構)屬於型別建模,進階內容見六種型別、數字精度與編碼陷阱。
JSON 陣列和物件可以互相轉換嗎?
可以但不對等。物件轉陣列通常意味著把鍵變成值(丟失按鍵查找的便利),陣列轉物件要給每個元素造一個鍵(鍵的來源就是新問題)。轉換前先想清楚消費端怎麼用,別只做語法搬運。
物件的鍵可以重複嗎?
語法上允許,RFC 8259 只是「應當」唯一。但 JavaScript 取最後一個值、部分 C 族庫取第一個,行為不一致;簽章、diff、雜湊場景重複鍵會直接造成結果分歧。產生側應避免,消費側遇到未知來源的資料要按不可信輸入處理。
陣列裡可以放不同型別的值嗎?
語法允許,[1, "a", true] 是合法 JSON。但異構陣列意味著消費端每個位置都要做型別判斷,Schema 也很難表達。除了矩陣、元組這類位置即語義的場景,盡量讓陣列保持同構。
為什麼 {name:'json'} 校驗不過?
因為 JSON 規定鍵和字串值都必須用雙引號。{name:'json'} 是 JavaScript 物件字面量,不是 JSON。改成 {"name": "json"} 就能通過校驗;需要單引號、裸鍵、註解的寫法屬於 JSON5/JSONC 方言,要用對應解析器而不是標準 JSON.parse。