cJSON库：嵌入式开发中的轻量级JSON解析方案
1. cJSON库概述
在嵌入式开发中，处理JSON数据是一项常见需求。cJSON是一个轻量级的C语言JSON解析库，特别适合资源受限的嵌入式环境。它采用单文件实现，仅包含cJSON.c和cJSON.h两个文件，便于集成到各类嵌入式项目中。
cJSON的主要特点包括：
- 完全符合ANSI-C标准
- 仅依赖标准库，无额外依赖
- 内存占用极小（通常仅几十KB）
- 支持完整的JSON解析和生成功能
- 采用MIT开源协议
提示：在Linux系统编译时需链接数学库，使用gcc编译时应添加-lm参数
2. cJSON核心数据结构
2.1 cJSON结构体解析
cJSON的核心是cJSON结构体，定义如下：
typedef struct cJSON { struct cJSON *next,*prev; // 双向链表指针 struct cJSON *child; // 子节点指针 int type; // 数据类型标识 char *valuestring; // 字符串类型值 int valueint; // 整型值 double valuedouble; // 浮点型值 char *string; // 键名 } cJSON;该结构体设计特点：
- 采用双向链表组织同级节点
- 通过child指针实现层次结构
- type字段标识7种JSON数据类型：
- cJSON_False (0)
- cJSON_True (1)
- cJSON_NULL (2)
- cJSON_Number (3)
- cJSON_String (4)
- cJSON_Array (5)
- cJSON_Object (6)
2.2 内存管理机制
cJSON采用动态内存分配策略：
- 创建节点时分配堆内存
- 使用后必须手动调用cJSON_Delete()释放
- 删除父节点会自动递归删除所有子节点
重要：每个cJSON_Create*函数创建的节点都必须最终被cJSON_Delete释放
3. JSON数据构建API
3.1 基础类型创建
cJSON提供全套类型创建函数：
// 基本类型 cJSON_CreateNull(); // 创建null值 cJSON_CreateBool(1); // 创建布尔值 cJSON_CreateNumber(3.14); // 创建数值 cJSON_CreateString("text"); // 创建字符串 // 复合类型 cJSON_CreateArray(); // 创建空数组 cJSON_CreateObject(); // 创建空对象3.2 数组便捷函数
对于数组操作，cJSON提供批量创建函数：
int numbers[] = {1,2,3}; cJSON_CreateIntArray(numbers, 3); // 整型数组 char* strings[] = {"a","b"}; cJSON_CreateStringArray(strings, 2); // 字符串数组3.3 对象操作API
向对象添加键值对的核心函数：
void cJSON_AddItemToObject(cJSON *object, const char *key, cJSON *item);配套的宏定义简化操作：
cJSON_AddStringToObject(obj, "key", "value"); cJSON_AddNumberToObject(obj, "age", 25); cJSON_AddBoolToObject(obj, "flag", 1);4. JSON序列化与解析
4.1 序列化选项
cJSON提供三种序列化方式：
char *cJSON_Print(cJSON *item); // 格式化输出(带缩进) char *cJSON_PrintUnformatted(cJSON *item); // 紧凑输出 char *cJSON_PrintBuffered(cJSON *item, int prebuffer, int fmt); // 缓冲输出注意：Print系列函数返回的字符串需要手动free释放
4.2 JSON解析流程
解析JSON字符串的基本流程：
char *json_string = "{\"name\":\"value\"}"; cJSON *root = cJSON_Parse(json_string); if(!root) { // 解析错误处理 printf("Error: %s\n", cJSON_GetErrorPtr()); } else { // 使用解析结果 cJSON_Delete(root); // 最后记得释放 }5. 实战应用示例
5.1 构建复杂JSON结构
创建嵌套的JSON对象和数组：
cJSON *root = cJSON_CreateObject(); cJSON *array = cJSON_CreateArray(); // 向数组添加元素 cJSON_AddItemToArray(array, cJSON_CreateString("item1")); cJSON_AddItemToArray(array, cJSON_CreateNumber(100)); // 向对象添加数组 cJSON_AddItemToObject(root, "data", array); // 序列化输出 char *json = cJSON_Print(root); printf("%s\n", json); // 清理 free(json); cJSON_Delete(root);5.2 解析复杂JSON数据
处理嵌套JSON数据的典型流程：
char *json = "{\"users\":[{\"name\":\"Alice\",\"age\":25},{\"name\":\"Bob\",\"age\":30}]}"; cJSON *root = cJSON_Parse(json); if(root) { cJSON *users = cJSON_GetObjectItem(root, "users"); if(users && cJSON_IsArray(users)) { int count = cJSON_GetArraySize(users); for(int i=0; i<count; i++) { cJSON *user = cJSON_GetArrayItem(users, i); cJSON *name = cJSON_GetObjectItem(user, "name"); cJSON *age = cJSON_GetObjectItem(user, "age"); printf("User %d: %s, %d\n", i+1, name->valuestring, age->valueint); } } cJSON_Delete(root); }6. 性能优化与注意事项
6.1 内存管理最佳实践
- 始终成对使用Create和Delete
- 对cJSON_Print的输出及时free
- 在内存受限系统中：
- 优先使用PrintUnformatted减少内存使用
- 考虑使用PrintBuffered控制缓冲区大小
6.2 错误处理建议
- 检查所有cJSON_Parse的返回值
- 使用cJSON_GetErrorPtr获取解析错误位置
- 对不确定的类型先用cJSON_Is*函数检查
6.3 嵌入式环境适配技巧
- 可修改cJSON.h中的内存管理宏：
#define cJSON_malloc malloc #define cJSON_free free - 对于无文件系统的环境，可直接包含.c文件
- 关闭格式化输出可节省约30%内存
7. 常见问题解决方案
7.1 解析失败排查
- 检查JSON字符串是否合法
- 确认字符串中的引号正确转义
- 验证内存是否充足
7.2 内存泄漏预防
- 确保每个Create都有对应的Delete
- 使用valgrind等工具检测内存问题
- 建立资源获取即释放(RAII)的编码习惯
7.3 性能优化案例
实测对比（STM32F407@168MHz）：
- 解析1KB JSON：约15ms
- 生成1KB JSON：约20ms 优化建议：
- 减少动态内存分配次数
- 复用cJSON对象
- 避免频繁的序列化/反序列化