在開發微信平台或任何需要資料交換的應用時,JSON 是常見的輕量級格式。它看起來簡單,但如果忽略物件與陣列的差異,常會在序列化後發現結構不如預期。
JSON 主要包含兩種類型:鍵值對組成的物件,以及依序排列的陣列。物件強調「名稱對應值」,不同語言可能有不同稱呼,例如 Python 的字典、JavaScript 的物件;陣列則強調順序與索引。
以 PHP 的 json_encode 為例,若資料是關聯陣列,輸出可能會像物件;若希望輸出真正的 JSON 陣列,就要確保輸入是連續索引的陣列。這也是微信選單這類需要 button 為陣列的結構,特別容易踩到的坑。
在送出資料前,先確認最外層需要物件還是陣列。若欄位名稱固定,使用物件;若多個同類項目需要按順序排列,使用陣列。必要時可使用 array_values 等工具重整索引,讓輸出符合預期。