Mảng và đối tượng JSON: cấu trúc và lồng nhau cho người mới
Kết luận: JSON chỉ có hai container: object cho các trường đặt tên, array cho các danh sách có thứ tự. Học cách kết hợp chúng, chọn đúng loại và sửa ba lỗi thường gặp nhất — mảng giả với khóa số, dấu phẩy thừa ở cuối và dấu nháy đơn.

JSON chỉ cho bạn hai container: object mang các trường đặt tên, array mang các danh sách có thứ tự — và gần như mọi payload hỏng đều được giải thích bởi dấu nháy, dấu phẩy, hoặc một danh sách được viết như một object giả.
Một: JSON chỉ có hai container
Phức tạp đến đâu một phản hồi API, tất cả cũng quy về hai container và sáu kiểu giá trị. Object là một tập hợp các cặp khóa/giá trị bọc trong ngoặc nhọn {}; array là một danh sách có thứ tự các giá trị bọc trong ngoặc vuông []. Một giá trị có thể là chuỗi, số, true, false, null — hoặc lại là object hay array. Object trong array, array trong object: đệ quy này là toàn bộ sức biểu đạt của JSON.
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
Từ đó có một kết luận thực dụng: trước một payload khó hiểu, đừng đọc từng ký tự. Hãy kiểm tra trước ký tự ngoài cùng là { hay [. Nếu là object, đọc nó như các trường đặt tên; nếu là array, đọc như danh sách rồi đi xuống từng tầng. Sơ đồ cú pháp trên json.org chỉ gói được trong một trang chính vì hai cấu trúc cộng đệ quy bao trùm tất cả.
Hai: viết object, bốn quy tắc cứng
Object là nơi người mới mắc lỗi nhiều nhất, nhưng quy tắc quy về bốn điều:
- Khóa phải là chuỗi trong dấu nháy kép.
{name: "Ada"}và{'name': 'Ada'}đều không hợp lệ; phải viết{"name": "Ada"}. Object literal của JavaScript cho phép khóa trần và nháy đơn, JSON thì không — đây là chỗ nhầm lẫn phổ biến nhất giữa hai thứ. - Phân tách các cặp bằng dấu phẩy và không bao giờ để dấu phẩy sau cặp cuối.
{"a": 1, "b": 2,}lỗi vớiUnexpected token }tại ngoặc nhọn đóng. - Khóa nên là duy nhất. RFC 8259 diễn đạt điều này là SHOULD, không phải MUST: khóa trùng không gây lỗi, nhưng giữ giá trị đầu hay giá trị cuối phụ thuộc vào phần cài đặt, và các ngôn ngữ không thống nhất. Đừng bao giờ dựa vào đó.
- Thứ tự khóa không mang ý nghĩa.
{"a":1,"b":2}và{"b":2,"a":1}là cùng một object; công cụ diff và hàm so sánh bỏ qua thứ tự khóa. Nếu thứ tự quan trọng, dữ liệu thuộc về array.
Ba: viết array, thứ tự chính là dữ liệu
Array lưu giá trị theo vị trí và đánh chỉ số bắt đầu từ 0: trong ["admin", "editor"], chuỗi "editor" là [1]. Thứ tự này có ý nghĩa — đó là khác biệt cốt lõi giữa array và object. Kết quả tìm kiếm xếp theo mức phù hợp, bản ghi log xếp theo ngày: thông tin này chỉ sống trong chuỗi trình tự, và biến nó thành object là phá hủy nó.
Hai khuyến nghị thực dụng. Một là, giữ các phần tử đồng nhất: [{"id":1},{"id":2}] dễ tiêu thụ hơn nhiều so với [1, "text", true] — hợp lệ nhưng buộc mọi bên tiêu thụ phải kiểm tra kiểu ở từng bước. Hai là, array rỗng [] là một giá trị hoàn toàn hợp lệ — khi trường danh sách chưa có nội dung, hãy trả [] thay vì null, để bên tiêu thụ khỏi phải kiểm tra tồn tại rồi lại kiểm tra rỗng.
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
Bốn: lồng nhau, bốn hình dạng của payload thật
Dữ liệu thật chỉ là hai container lồng vào nhau, và các mẫu quy về bốn hình dạng:
| Hình dạng | Trông như thế nào | Dùng điển hình |
|---|---|---|
| Object chứa array | {"tags": ["a","b"]} |
Trường danh sách của một thực thể |
| Array của object | [{"id":1},{"id":2}] |
Danh sách bản ghi, kết quả phân trang |
| Object chứa object | {"db": {"host": "..."}} |
Cấu hình gộp nhóm, khối địa chỉ |
| Array của array | [[1,2],[3,4]] |
Ma trận, hàng bảng |
Một phản hồi API điển hình dùng object làm vỏ và array làm nội dung:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
Đừng lồng nhau vì lồng nhau. Quá ba hoặc bốn tầng, đường truy cập trở nên khó đọc và mã của bên tiêu thụ phình ra theo tỷ lệ. Các trường luôn đi cùng nhau thuộc về một object con: thay addrCity và addrZip bằng address: {city, zip}.
Năm: object hay array, bảng quyết định
| Câu hỏi | Trả lời | Vì sao |
|---|---|---|
| Mỗi giá trị có tên riêng? | Object | Truy cập bằng khóa; thêm hoặc bỏ trường không phá gì |
| Là danh sách các bản ghi giống nhau? | Array | Thứ tự quan trọng; có thể map và filter |
| Cần tra cứu nhanh theo khóa? | Object đánh chỉ mục theo mã định danh | Truy cập O(1) thay vì duyệt |
| Nhiều thuộc tính của một thực thể? | Object | Các thuộc tính không có thứ tự riêng |
| Bộ sưu tập tăng dần các phần tử giống nhau? | Array | Độ dài co giãn tự do |
Một anti-pattern đáng nhắc riêng: bắt chước array bằng object có khóa "0", "1", "2". Nó parse không lỗi, nhưng bạn mất ngữ nghĩa độ dài và công cụ lặp của array thật, và bên tiêu thụ phải sắp xếp Object.keys trước khi đọc được gì. Nếu khóa là số thứ tự, hãy viết array thật. Chiều ngược lại cũng đúng: danh sách các cặp khóa/giá trị như [{"key":"theme","value":"dark"}] thua object {"theme": "dark"} — trừ khi khóa thật sự động và không thể khai báo trước.
Sáu: ba lỗi thường gặp và thông báo của chúng
| Dạng sai | Lỗi điển hình | Cách sửa |
|---|---|---|
Dấu phẩy cuối {"a":1,} |
Unexpected token } |
Bỏ dấu phẩy cuối |
Nháy đơn / khóa trần {name:'Ada'} |
Unexpected token ' / Expected property name |
Nháy kép cho khóa và chuỗi, luôn luôn |
Literal của Python True / None |
Unexpected token T |
Thay bằng true / null |
| Mảng giả với khóa số | Không lỗi, ngữ nghĩa sai | Viết lại thành array thật |
Hai thói quen gỡ lỗi: parser thường báo vị trí sau ký tự lỗi, nên khi thấy position 42, hãy nhìn lùi một hoặc hai ký tự; và JSON khổng lồ trên một dòng nên được định dạng trước — số dòng và cột luôn thắng độ lệch ký tự. Toàn bộ danh mục lỗi nằm ở bảng tra lỗi JSON, quy trình phân loại từng bước nằm ở cách sửa lỗi parse JSON.
Bảy: sau khi viết, kiểm tra cấu trúc
JSON viết tay luôn phải qua parser trước khi bàn giao. Lượt kiểm nhẹ nhất gói trong một dòng lệnh:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
Trực tuyến, dán nội dung vào trang định dạng và kiểm tra JSON — lỗi cú pháp sẽ trả về kèm dòng và cột. Chuyển sang chế độ xem cây để thấy kiểu của từng tầng trong một cái nhìn: có số nào bị hiểu thành chuỗi không, độ dài các array có khớp nhau không. Và khi độc giả không chuyên kỹ thuật, payload dạng array-of-objects có thể dàn thành hàng và cột trên trang JSON sang bảng, nhân tiện kiểm tra luôn dữ liệu của bạn có thật sự là danh sách bản ghi đều nhau không.
Những câu hỏi về trường lẽ ra phải là array, hay về việc làm lại cấu trúc lồng quá sâu, thuộc về mô hình hóa kiểu dữ liệu — bài đọc tiếp theo: sáu kiểu, độ chính xác số và bẫy mã hóa.
Mảng và đối tượng JSON có thể chuyển đổi cho nhau không?
Có thể, nhưng không phải không mất dữ liệu. Chuyển object thành array thường có nghĩa là biến khóa thành giá trị và mất truy cập theo khóa; chuyển array thành object đòi hỏi phải đặt khóa cho từng phần tử, và nguồn gốc các khóa đó là một bài toán thiết kế mới. Hãy quyết định theo cách bên tiêu thụ đọc dữ liệu, không phải theo tiện cú pháp.
Khóa của object có thể trùng nhau không?
Về cú pháp thì được — RFC 8259 chỉ nói khóa NÊN là duy nhất. Nhưng JavaScript giữ giá trị cuối trong khi một số thư viện dòng C giữ giá trị đầu: hành vi khác nhau giữa các parser. Trong chữ ký, diff hay băm, khóa trùng gây bất đồng trực tiếp. Tránh ở phía sản xuất, và coi bản trùng từ nguồn không rõ là rủi ro phía tiêu thụ.
Array có thể chứa giá trị khác kiểu không?
Về cú pháp thì được: [1, "a", true] là JSON hợp lệ. Nhưng array không đồng nhất buộc bên tiêu thụ phải kiểm tra kiểu ở từng vị trí, và khó mô tả trong schema. Trừ ma trận và tuple — nơi vị trí chính là ngữ nghĩa — hãy giữ array đồng nhất.
Vì sao {name:'json'} không qua được kiểm tra?
Vì JSON đòi hỏi dấu nháy kép bao quanh mọi khóa và mọi giá trị chuỗi. {name:'json'} là object literal của JavaScript, không phải JSON. Thay bằng {"name": "json"} là kiểm tra sẽ qua. Nháy đơn, khóa trần và chú thích thuộc về các phương ngôn như JSON5/JSONC, vốn cần parser riêng thay vì JSON.parse chuẩn.