C语言JSON解析入门教程（手把手教你用C语言轻松解析JSON数据）

为什么选择 cJSON？

cJSON 是一个开源、轻量、易于集成的 C 语言 JSON 库，由 Dave Gamble 开发。它具有以下优点：

• 代码简洁，仅需两个文件（cJSON.c 和 cJSON.h）
• 支持 JSON 的解析（parse）和生成（print）
• 非常适合资源受限的嵌入式系统
• 广泛应用于物联网（IoT）、单片机等场景

第一步：下载并集成 cJSON

你可以从 cJSON 的 GitHub 仓库下载源码：

https://github.com/DaveGamble/cJSON

下载后，将 cJSON.c 和 cJSON.h 文件复制到你的项目目录中，并在你的 C 源文件中包含头文件：

#include "cJSON.h"#include <stdio.h>#include <stdlib.h>#include <string.h>  

第二步：编写一个简单的 JSON 解析程序

假设我们有如下 JSON 字符串：

{  "name": "张三",  "age": 28,  "is_student": false,  "courses": ["数学", "物理"]}  

我们要从中提取 name、age 等字段。以下是完整的 C 语言代码：

#include "cJSON.h"#include <stdio.h>#include <stdlib.h>#include <string.h>int main() {    // 定义 JSON 字符串    const char* json_str = "{\n"        "  \"name\": \"张三\",\n"        "  \"age\": 28,\n"        "  \"is_student\": false,\n"        "  \"courses\": [\"数学\", \"物理\"]\n"        "}";    // 解析 JSON 字符串    cJSON *root = cJSON_Parse(json_str);    if (root == NULL) {        const char *error_ptr = cJSON_GetErrorPtr();        if (error_ptr != NULL) {            fprintf(stderr, "JSON 解析错误: %s\n", error_ptr);        }        return EXIT_FAILURE;    }    // 获取 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);    }    // 获取 is_student 字段    cJSON *is_student = cJSON_GetObjectItemCaseSensitive(root, "is_student");    if (cJSON_IsBool(is_student)) {        printf("是否学生: %s\n", cJSON_IsTrue(is_student) ? "是" : "否");    }    // 遍历 courses 数组    cJSON *courses = cJSON_GetObjectItemCaseSensitive(root, "courses");    if (cJSON_IsArray(courses)) {        printf("课程列表:\n");        cJSON *course;        cJSON_ArrayForEach(course, courses) {            if (cJSON_IsString(course)) {                printf("  - %s\n", course->valuestring);            }        }    }    // 释放内存    cJSON_Delete(root);    return EXIT_SUCCESS;}  

第三步：编译与运行

将上述代码保存为 main.c，然后使用以下命令编译（假设 cJSON.c 与 main.c 在同一目录）：

gcc main.c cJSON.c -o json_parser  

运行程序：

./json_parser  

你将看到如下输出：

姓名: 张三年龄: 28是否学生: 否课程列表:  - 数学  - 物理  

常见问题与注意事项

• 内存管理：每次调用 cJSON_Parse 后，必须调用 cJSON_Delete 释放内存，否则会造成内存泄漏。
• 错误处理：务必检查 cJSON_Parse 的返回值，避免程序崩溃。
• 中文支持：cJSON 支持 UTF-8 编码的中文字符串，确保你的源文件和终端编码一致。

总结

通过本教程，你已经掌握了如何在 C 语言中使用 cJSON 库进行 C语言JSON解析。无论是开发 嵌入式JSON解析 应用，还是处理配置文件，cJSON 都是一个高效可靠的选择。希望你能将所学应用到实际项目中，提升开发效率！

如果你正在寻找一个 轻量级JSON库 来处理 C语言解析JSON数据 的任务，cJSON 绝对值得尝试。