JSON 基础知识（一）

第一部分：JSON 基础知识

📢 快速掌握 JSON！文章 + 视频双管齐下 🚀

如果你觉得阅读文章太慢，或者更喜欢 边看边学 的方式，不妨直接观看我录制的 JSON 课程视频！🎬 视频里会用更直观的方式讲解 JSON 的核心概念、实战技巧，并配有动手演示，让你更高效地掌握 JSON 的处理方法！

当然，如果你喜欢深度阅读，这篇文章会帮助你系统地理解 JSON，从基础到进阶！无论你选择哪种方式，最终目标都是让你成为 JSON 处理的高手！💪

🎥 点击这里观看视频 👉 视频链接

一：JSON 介绍

1.1 JSON 是什么？

• JSON（JavaScript Object Notation） 是一种轻量级的数据交换格式，主要用于前后端数据传输、配置文件存储、API 交互等。
• 它基于 JavaScript 语言的对象表示法，但与编程语言无关，因此被广泛应用于 C/C++、Python、Java、Go、Rust 等语言中。

1.2 JSON 的特点及优点

✅ 可读性强：JSON 采用 键值对（Key-Value） 结构，语法简单直观，易于人和机器解析。
✅ 轻量级：相比 XML，JSON 体积更小，解析速度更快。
✅ 跨语言兼容：JSON 可以在不同的编程语言之间交换数据，各种语言都支持 JSON 解析。
✅ 层次结构（嵌套）：支持 数组、对象、嵌套数据结构，适合存储复杂数据。
✅ 无格式要求：不需要像 XML 那样定义模式（Schema），使用灵活。

1.3 JSON 与 XML 的对比

JSON 与 XML（Extensible Markup Language）都是常见的数据交换格式，以下是它们的区别：

对比项	JSON	XML
数据结构	键值对（Key-Value）	标签（Tag-Based）
可读性	结构清晰，易理解	层级嵌套复杂
解析效率	解析速度快	解析速度慢
数据体积	体积小	体积较大
可扩展性	适用于结构化数据	适用于更复杂的数据格式

📌 JSON 与 XML 实例对比

✅ JSON 格式数据：

{"person": {"name": "张三","age": 25,"hobbies": ["篮球", "足球"],"sex":"男"}
}

✅ XML 格式数据：

<person><name>张三</name><age>25</age><hobbies><hobby>篮球</hobby><hobby>足球</hobby></hobbies><sex>男</sex>
</person>

结论：

• JSON 结构更加紧凑，更适合数据交换。
• XML 适合文档存储（如配置文件、HTML、RSS 订阅等）。

二：JSON 的数据结构和语法

2.1 JSON 的数据结构

• JSON 由 对象（Object） 和 数组（Array） 组成，核心元素包括：
  • 对象（使用 {} 表示，存储键值对）
  • 数组（使用 [] 表示，存储多个值）
  • 值类型（支持 字符串、数值、布尔值、null、对象、数组）

JSON 支持以下六种数据类型：

数据类型	示例	描述
对象（Object）	{ "name": "张三", "age": 25 }	键值对的集合，类似于 C++ 的 std::map 或 Python 的字典
数组（Array）	[1, 2, 3, 4]	有序的值列表，对应 C++ 的 std::vector 或 Python 的列表
字符串（String）	"hello"	双引号包裹的文本数据, 必须使用双引号 ""，不能使用单引号
数值（Number）	123，3.14	整数或浮点数
布尔值（Boolean）	true，false	逻辑值 true 和 false
空值（null）	null	表示空对象

2.2 JSON 语法规则

JSON 数据的核心是键值对（Key-Value），其中：

• 键（Key）必须是字符串，且用双引号 "" 包围。
• 值（Value）可以是字符串、数值、布尔值、数组、对象或 null。
• 多个键值对之间用 逗号 , 分隔，对象用 大括号 {} 包围，数组用 方括号 [] 包围。
• 字符串 必须使用双引号 ""。

📌 示例：一个完整的 JSON 数据结构

{"name": "Alice","age": 25,"is_student": false,"skills": ["C++", "Python", "JavaScript"],"address": {"city": "New York","zip_code": "10001"},"null":null
}

📌 解析该 JSON 结构：

• name：字符串 "Alice"
• age：数值 25
• is_student：布尔值 false
• skills：数组 ["C++", "Python", "JavaScript"]
• address：嵌套对象，包含 city 和 zip 两个键值对

JSON 解析后相当于 C 语言的结构体：

struct Address {char city[20];char zip_code[10];
};struct Person {char name[20];int age;int is_student;char* skills[3];struct Address address;
};

---

2.3 JSON 语法规则（重要）

​ ❌ 错误示例（常见语法错误）：

{name: "张三",   // ❌ 错误：键名必须使用双引号"age": 25,    "hobbies": [ "篮球", "足球", ], // ❌ 错误：数组最后一个元素后不能有逗号"address": { "city": "上海", "zip_code": "200000", } // ❌ 错误：对象最后一个键值对后不能有逗号
}

​ ✅ 正确格式：

{"name": "张三","age": 25,"hobbies": ["篮球", "足球"],"address": { "city": "上海", "zip_code": "200000" }
}

三：JSON 的实际应用场景

JSON 适用于多种编程场景，常见应用如下：

3.1 Web API 数据交互

服务器通过 REST API / GraphQL 以 JSON 格式返回数据，前端（Vue、React）解析 JSON 并展示(如 GET、POST 请求）。

JSON 替代 XML，成为 API 传输的主流数据格式。

📌 示例：前端 JavaScript 发送 JSON 请求到服务器

fetch("https://api.example.com/user", {method: "POST",headers: { "Content-Type": "application/json" },body: JSON.stringify({ name: "Alice", age: 25 })
})
.then(response => response.json())
.then(data => console.log(data));

3.2 配置文件存储

JSON 用于软件、Web 服务器、数据库的 配置文件，如 config.json。
📌 示例：Web 服务器 Nginx 的配置

{"server": "localhost","port": 8080,"enable_ssl": true
}

3.3 数据存储与日志管理

JSON 可用于存储日志、数据缓存，如 NoSQL 数据库（MongoDB）使用 JSON 作为存储格式。
📌 MongoDB 文档存储示例

{"_id": "user123","username": "Alice","email": "[e-mail]"
}

3.4 机器学习与日志分析

• 训练数据、日志文件等大量使用 JSON 进行数据存储。
• 便于后续分析和处理。

JSON 适用于存储服务器日志：

{"timestamp": "2024-02-09T12:30:45Z","level": "ERROR","message": "数据库连接失败","details": {"host": "db.example.com","port": 3306}
}

日志分析工具可以轻松解析 JSON 日志，进行故障排查！

3.5 物联网（IoT）

• IoT 设备通过 JSON 格式传输传感器数据。

• 示例：

  {"device_id": "sensor_001","temperature": 22.5,"humidity": 60
  }
  

四：JSON 解析和生成

3.1 JSON 解析（Parsing）和生成（Serialization）概述

• 解析（Parsing）：把 JSON 字符串转换为可操作的数据结构（C 结构体或 C++ 类）。
• 序列化（Serialization）：把 C/C++ 数据结构转换为 JSON 字符串，便于存储和传输。

3.2 JSON 在不同编程语言中的支持情况

• C 语言处理 JSON 需要使用专门的解析库（如 cJSON）。

• C++ 提供多个 JSON 库（RapidJSON、JsonCpp、nlohmann/json等）。

3.3 JSON 解析的基本流程

• 步骤 1：读取 JSON 数据（从字符串或文件）。
• 步骤 2：解析 JSON 并存入内存中的数据结构。
• 步骤 3：访问 JSON 数据（读取键值、遍历数组）。
• 步骤 4：修改 JSON 数据（添加/删除键值对）。
• 步骤 5：将数据重新序列化为 JSON 字符串，供存储或网络传输。

示例代码（伪代码，后续库会具体实现）

char* json_string = "{ \"name\": \"张三\", \"age\": 25 }";
JsonObject obj = json_parse(json_string);
printf("姓名: %s\n", json_get_string(obj, "name"));
json_set_number(obj, "age", 26);
char* new_json_string = json_serialize(obj);
printf("修改后的 JSON: %s\n", new_json_string);

3.4 C/C++ 解析 JSON 的常见库对比

• cJSON、RapidJSON、JsonCpp、JSON for Modern C++

3.4.1 cJSON📌

• 概述

  • cJSON 是一个轻量级的 C 语言实现的 JSON 库，专为嵌入式设备和资源受限的环境设计。

  • 它非常简洁，适合简单的 JSON 数据解析任务。

• 特点

  • 纯 C 实现：没有任何外部依赖，适用于嵌入式开发和低资源环境。

  • API 简单直观：易于上手，接口简单，适合 C 开发者。

  • 内存管理：需要手动管理内存，易产生内存泄漏问题。

• 性能表现

  • 在单线程和小数据量的情况下，cJSON 解析性能较好，但在处理大量数据时，性能会略显不足。

• 使用场景

  • 嵌入式设备开发（如 IoT）

  • 需要轻量化的 JSON 解析任务

• 优缺点

  优点

  • 轻量级：非常适合资源受限的嵌入式系统。
  • 易用性高：API 设计简洁，快速上手。
  • 没有外部依赖：纯 C 实现，不依赖其他库。

  缺点

  • 性能限制：在大数据量处理上，性能和内存管理上有一定的瓶颈。
  • 内存管理手动：需要开发者自己管理内存，容易引入内存泄漏问题。

---

3.4.2 RapidJSON📌

• 概述

  • RapidJSON 是一个 C++ 实现的高性能 JSON 解析库，强调 速度 和 低内存使用，支持 SAX 和 DOM 解析方式。

  • 它是 C++ 中最受欢迎的 JSON 解析库之一，适用于高性能的 JSON 解析场景。

• 特点

  • C++ 实现：支持现代 C++ 语法和标准，适用于 C++ 开发者。

  • 高性能：在解析速度和内存占用方面，尤其是在大数据量时具有明显优势。

  • 流式解析（SAX）：支持流式解析，可以在解析大 JSON 文件时避免内存占用过高。

• 性能表现

  • 解析速度：在大数据量 JSON 解析时，RapidJSON 表现出色，比大多数 C++ 库要快。

  • 内存使用：内存使用高效，适合需要优化性能的场景。

• 使用场景

  • 高性能计算和大数据处理

  • 日志解析

  • 金融、游戏、科学计算等需要高效解析的大型 JSON 数据

• 优缺点

  优点

  • 高性能：在大数据量的解析上，表现比其他库更好。
  • 支持流式解析：适合大文件的逐步解析，内存消耗低。
  • 支持标准 C++：支持 C++11 和以上标准，现代化的接口。

  缺点

  • 不支持动态内存管理：需要开发者自己处理内存分配与管理。
  • 接口复杂：与其他库相比，API 比较复杂，上手稍有难度。

---

3.4.3 JsonCpp📌

• 概述

  • JsonCpp 是一个功能强大的 C++ JSON 解析库，旨在提供一种简单的接口来操作 JSON 数据。

  • 适用于中到大型 C++ 项目的 JSON 数据解析与操作。

• 特点

  • C++ 实现：适用于 C++ 项目，API 风格符合 C++ 的习惯。

  • 支持读取和写入 JSON：不仅可以解析 JSON，还可以方便地将数据写回 JSON 格式。

  • 与 STL 兼容：可以直接与 C++ 的 std::string 和 std::vector 等数据结构进行交互。

• 性能表现

  • 解析速度：性能中等，适合大多数应用场景，尤其是中等规模的数据解析。

  • 内存消耗：内存使用较为稳定，但与 RapidJSON 相比，速度稍慢。

• 使用场景

  • 配置文件解析

  • 常见桌面应用的数据存储

  • 需要 JSON 读写操作的场景

• 优缺点

  优点

  • API 易用性：符合 C++ 风格的接口，易于开发者上手。
  • 功能全面：除了 JSON 解析，还支持 JSON 数据的生成与修改。
  • STL 兼容性强：可以与 C++ 标准库的容器和数据结构无缝对接。

  缺点

  • 性能一般：在大数据量处理时，解析速度较慢，内存消耗较高。
  • 库体积较大：相比其他库，JsonCpp 的体积稍大，可能不适合嵌入式设备。

---

3.4.4 JSON for Modern C++📌

• 概述

  • JSON for Modern C++（由 nlohmann/json 提供）是一个流行的 C++ JSON 库，利用 C++11 特性，如 std::string、std::vector 等，提供直观的 JSON 处理接口。

  • 支持与标准 C++ 容器类型（如 std::map、std::vector）的无缝集成。

• 特点

  • C++11 风格 API：现代化的接口，支持 std::vector、std::map 等 C++ 标准库容器。

  • JSON 数据转换：提供简洁的方式将 C++ 对象转换为 JSON，反之亦然。

  • 简洁易用：API 设计现代且简洁，代码量少，易于理解。

• 性能表现

  • 解析速度：与 RapidJSON 相比稍慢，但仍适用于大多数应用场景。

  • 内存占用：内存使用高效，适合较大数据集。

• 使用场景

  • 现代 C++ 项目

  • 配置文件管理

  • Web 开发中前后端数据交互

• 优缺点

  优点

  • 易用性高：简洁的 API，适合现代 C++ 开发者。
  • 兼容性强：与标准 C++ 容器和 STL 兼容。
  • 支持转换 C++ 对象和 JSON：可以轻松将 C++ 对象序列化为 JSON，反之亦然。

  缺点

  • 性能相对较低：解析大规模 JSON 数据时，性能可能不如 RapidJSON。
  • 对旧版 C++ 不友好：要求至少 C++11。

---

3.4.5 总结📌

库	语言	性能	使用场景	优点	缺点
cJSON	C	中等	嵌入式开发、轻量级应用	轻量级、无依赖	性能不佳、内存管理手动
RapidJSON	C++	高性能	大数据解析、日志、API	快速、支持流式解析	API 复杂、内存管理手动
JsonCpp	C++	中等	中型 C++ 项目、配置文件	STL 兼容、功能全面	性能一般、库体积较大
JSON for Modern C++	C++	中等	现代 C++ 项目、Web 应用	简洁易用、C++11 风格	性能较低、仅支持 C++11 以上

五：JSON 的性能优化策略

5.1 避免 JSON 过度嵌套

过度嵌套会 影响解析速度，应尽量 扁平化 JSON 结构。

❌ 差的 JSON 结构（深度嵌套）

{"user": {"profile": {"details": {"name": "Alice"}}}
}

✅ 优化后（扁平化 JSON）

{"user_name": "Alice"
}

5.2 使用流式解析（SAX 解析）

对于 大 JSON 文件，不要一次性加载到内存，而使用 流式解析（SAX 解析）。

📌 C++ 解析 JSON 时使用 RapidJSON 流式解析（节省内存）

#include "rapidjson/reader.h"using namespace rapidjson;class MyHandler : public BaseReaderHandler<UTF8<>, MyHandler> {
public:bool String(const char* str, SizeType length, bool copy) {printf("解析到字符串: %s\n", str);return true;}
};int main() {const char* json = "{\"name\":\"Alice\",\"age\":25}";MyHandler handler;Reader reader;StringStream ss(json);reader.Parse(ss, handler);return 0;
}

---

5.3 常见问题分析与解决方案

问题	可能原因	解决方案
JSON 解析失败	语法错误（如 , 结尾）	使用 jsonlint 校验 JSON
JSON 体积过大	包含大量冗余数据	优化 JSON 结构，减少嵌套
解析速度慢	使用 DOM 解析大文件	采用 流式解析（SAX）
不支持 JSON 注释	JSON 规范不允许注释	使用 // 伪注释字段或 YAML

---