简单介绍json的格式及注意事项

JSON（JavaScript Object Notation，JavaScript 对象表示法）是一种轻量级的数据交换格式。它采用完全独立于编程语言的文本格式，易于人类阅读和编写，同时也易于机器解析和生成。

---

1. JSON 的核心语法格式

JSON 建立在两种数据结构之上：键值对的集合（对象）和值的有序列表（数组）。

基础数据类型

JSON 支持以下 6 种标准数据类型：

1. 字符串（String）：必须使用**双引号 ""** 包裹（例如 "hello"）。
2. 数字（Number）：可以是整数或浮点数（例如 42、3.14、-10）。
3. 布尔值（Boolean）：只能是全小写的 true 或 false。
4. 空值（Null）：只能是全小写的 null。
5. 对象（Object）：使用花括号 {} 包裹的键值对。
6. 数组（Array）：使用方括号 [] 包裹的值序列。

示例代码

{
  "name": "Alex",
  "age": 28,
  "isDeveloper": true,
  "skills": ["Python", "JavaScript", "SQL"],
  "address": {
    "city": "Shanghai",
    "zipCode": "200000"
  },
  "middleName": null
}

---

2. 编写和使用 JSON 的核心注意事项（避坑指南）

JSON 语法非常严格，任何微小的格式错误都会导致解析失败（如抛出 SyntaxError）。以下是开发中最容易踩坑的地方：

❌ 常见的语法禁忌

1. 绝对不能使用单引号

• 错误的写法：{'name': 'Alex'}
• 正确的写法：{"name": "Alex"}
• 注意：JSON 的键（Key）和字符串值（Value）必须使用双引号。

2. 键名（Key）必须是双引号包裹的字符串

• 错误的写法：{ name: "Alex" }
• 正确的写法：{ "name": "Alex" }

3. 不能有末尾多余的逗号（Trailing Comma）

• 错误的写法：[1, 2, 3, ] 或 {"a": 1, "b": 2,}
• 正确的写法：[1, 2, 3] 或 {"a": 1, "b": 2}
• 注意：在数组或对象的最后一个元素后面加逗号是 JSON 报错的第一大来源。

4. 不支持注释

• 标准的 JSON 内部不允许出现 // 或 /* */ 注释。如果需要保存带注释的配置，通常会选择 JSONC、YAML 或 TOML。

5. 不能使用未定义的特殊数值

• JSON 不支持 undefined、NaN（非数字）或 Infinity（无穷大）。遇到这些数值时，通常需要转换为 null 或字符串。

6. 前导零（Leading Zero）限制

• 数字类型中不能以 0 开头（如 0123），除非它表示小数（如 0.123）。

---

3. 开发实战场景提示

• 字符编码：标准 JSON 统一采用 UTF-8 编码，跨平台传输时请务必保证编码一致，避免中文乱码。
• 数字精度问题：JSON 规范对数字精度没有限制，但在 JavaScript 等语言中解析时，超过 64 位整型限制的大数字（例如 18 位的数据库 ID 112233445566778899）可能会丢失精度。对于超大整数，建议在 JSON 中存为字符串格式（如 "112233445566778899"）。