JSON 工具箱

JSON 陣列和物件怎麼寫:結構與巢狀入門

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

入門約 6 分鐘發佈於 2026-11-20更新於 2026-11-20
JSON 陣列與物件結構入門封面

JSON 只給你兩種容器:物件負責「有名字的欄位」,陣列負責「按順序排列的列表」——寫不對的九成問題出在引號、逗號,以及把列表寫成了偽物件。

一、JSON 只有兩種容器

不管介面回傳的資料有多複雜,拆到最後只有兩種容器和六種值。物件(object)是一組「鍵值對」,用花括號 {} 包起來;陣列(array)是一串按順序排列的值,用方括號 [] 包起來。值可以是字串、數字、true/false、null,也可以再巢狀物件或陣列——物件套陣列、陣列套物件,就這樣組合出所有真實資料。

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

這個認知很實用:遇到看不懂的 JSON,不要從第一個字元往下讀,先找最外層是 { 還是 [。是物件,就按欄位理解;是陣列,就按列表理解,再逐層往裡拆。json.org 的語法圖一共只有一頁,原因正是如此:兩種結構加上遞迴巢狀,表達能力就夠用了。

二、物件的寫法:四條硬規則

物件是新手出錯最密集的地方,規則其實只有四條:

  1. 鍵必須是雙引號字串。{name: "Ada"}、{'name': 'Ada'} 都不合法,必須是 {"name": "Ada"}。JavaScript 物件字面量允許裸鍵和單引號,但 JSON 不允許——這是兩者最常見的混淆點。
  2. 鍵值對之間用逗號分隔,最後一個後面不能有逗號。{"a": 1, "b": 2,} 會在右花括號處報 Unexpected token }。
  3. 鍵應當唯一。RFC 8259 用的是 SHOULD 而不是 MUST,重複鍵不報錯,但取第一個還是最後一個由解析器決定,不同語言結果可能不同,不能依賴。
  4. 鍵的順序沒有語義。{"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。