C语言中高效处理JSON数据（cJSON库使用教程与入门指南）

安装与集成 cJSON

cJSON 使用非常简单，你只需要两个文件：cJSON.c 和 cJSON.h。你可以从其 GitHub 仓库 下载源码。

将这两个文件复制到你的项目目录中，并在你的 C 源文件中包含头文件：

#include "cJSON.h"

编译时记得链接 cJSON 源文件，例如使用 gcc 编译：

gcc main.c cJSON.c -lm -o my_program

注意：cJSON 使用了数学库（如 pow），所以需要加上 -lm 参数。

解析 JSON 字符串（反序列化）

假设我们有一个 JSON 字符串，表示用户信息：

{  "name": "张三",  "age": 28,  "is_student": false,  "hobbies": ["读书", "编程", "旅行"]}

我们可以使用 cJSON 来解析它并提取字段：

#include <stdio.h>#include <stdlib.h>#include "cJSON.h"int main() {    const char *json_str = "{\"name\":\"张三\",\"age\":28,\"is_student\":false,\"hobbies\":[\"读书\",\"编程\",\"旅行\"]}";    // 解析 JSON 字符串    cJSON *root = cJSON_Parse(json_str);    if (root == NULL) {        const char *error_ptr = cJSON_GetErrorPtr();        if (error_ptr != NULL) {            fprintf(stderr, "解析错误: %s\n", error_ptr);        }        return 1;    }    // 获取 name 字段    cJSON *name = cJSON_GetObjectItemCaseSensitive(root, "name");    if (cJSON_IsString(name) && (name->valuestring != NULL)) {        printf("姓名: %s\n", name->valuestring);    }    // 获取 age 字段    cJSON *age = cJSON_GetObjectItemCaseSensitive(root, "age");    if (cJSON_IsNumber(age)) {        printf("年龄: %d\n", age->valueint);    }    // 获取 hobbies 数组    cJSON *hobbies = cJSON_GetObjectItemCaseSensitive(root, "hobbies");    if (cJSON_IsArray(hobbies)) {        int size = cJSON_GetArraySize(hobbies);        printf("爱好 (%d 项): ", size);        for (int i = 0; i < size; i++) {            cJSON *item = cJSON_GetArrayItem(hobbies, i);            if (cJSON_IsString(item)) {                printf("%s ", item->valuestring);            }        }        printf("\n");    }    // 释放内存    cJSON_Delete(root);    return 0;}

运行后输出：

姓名: 张三年龄: 28爱好 (3 项): 读书 编程 旅行

生成 JSON 字符串（序列化）

除了解析，cJSON 还能帮你构建 JSON 对象。下面是一个创建用户信息 JSON 的例子：

#include <stdio.h>#include "cJSON.h"int main() {    // 创建根对象    cJSON *root = cJSON_CreateObject();    // 添加字符串字段    cJSON_AddStringToObject(root, "name", "李四");    // 添加数字字段    cJSON_AddNumberToObject(root, "age", 22);    // 添加布尔字段    cJSON_AddBoolToObject(root, "is_student", 1);    // 创建数组并添加元素    cJSON *hobbies = cJSON_CreateArray();    cJSON_AddItemToArray(hobbies, cJSON_CreateString("游泳"));    cJSON_AddItemToArray(hobbies, cJSON_CreateString("音乐"));    cJSON_AddItemToObject(root, "hobbies", hobbies);    // 将 cJSON 对象转为字符串    char *json_str = cJSON_Print(root);    if (json_str != NULL) {        printf("生成的 JSON:\n%s\n", json_str);        free(json_str); // cJSON_Print 返回的是 malloc 分配的内存    }    // 释放 cJSON 对象    cJSON_Delete(root);    return 0;}

输出结果：

生成的 JSON:{	"name":	"李四",	"age":	22,	"is_student":	true,	"hobbies":	["游泳", "音乐"]}

常见注意事项

• 每次调用 cJSON_Parse 或 cJSON_CreateObject 后，必须调用 cJSON_Delete 释放内存，避免内存泄漏。
• 使用 cJSON_Print 生成的字符串是动态分配的，记得用 free() 释放。
• 检查指针是否为 NULL，以及使用 cJSON_IsXXX 宏判断类型，可提高程序健壮性。

总结

通过本教程，你已经掌握了 cJSON库使用教程 的核心内容，包括如何解析和生成 JSON 数据。无论你是做 C语言JSON解析、开发嵌入式设备，还是学习 cJSON入门指南，cJSON 都是一个强大而简单的工具。对于资源有限的系统，嵌入式JSON处理 能力尤为重要，而 cJSON 正是为此而生。

赶快动手试试吧！如有疑问，欢迎查阅 cJSON 官方文档或在评论区留言交流。