Linux中封装JSON解析函数需聚焦空指针、类型误判、内存泄漏防护，推荐cJSON库并统一返回值（0成功，-1解析失败等），支持点号路径访问与类型安全提取。
在Linux中封装JSON解析提取函数，核心是把重复的解析逻辑、错误检查和内存管理收进一个可复用的接口里。关键不在于“写得多”，而在于“错得少”——尤其要防空指针、类型误判、内存泄漏这三类常见问题。
选对底层库再封装
先明确用哪个库，不同库封装方式差异明显：
-
cJSON：纯C，无依赖，适合嵌入式或轻量服务。封装时需手动调用
cJSON_Parse和cJSON_Delete，必须成对出现 -
json-c：提供
json_object类型，支持自动引用计数（json_object_put可安全释放），更适合常规应用 -
jsoncpp（C++）：RAII友好，对象析构自动清理，封装时可直接返回
Json::Value，无需显式释放
以cJSON为例的典型封装结构
假设只提取字符串字段，且保证输入JSON合法、字段存在：
- 函数签名建议：
int json_extract_string(const char *json_str, const char *key, char *out_buf, size_t buf_size) - 内部做三件事：解析 → 查键 → 拷贝并截断（防止溢出）→ 清理
- 返回值统一：0表示成功，-1表示解析失败，-2表示键不存在，-3表示类型不符或缓冲区不足
- 不返回指针，避免调用方误用未分配内存；也不暴露
cJSON *，隔离实现细节
处理嵌套与数组的封装要点
遇到 {"data": {"user": {"name": "Tom"}}, "items": [{"id": 1}, {"id": 2}]} 这类结构，封装时要支持路径式访问：
- 可接受点号分隔的路径，如
"data.user.name"或"items.0.id" - 对
.0这类数组索引，需拆解路径、逐层进入：先取"items"（确认是数组），再取第0项，再取"id" - 不要硬编码层级上限，用循环+栈模拟路径遍历，避免
cJSON_GetObjectItem嵌套过深导致可读性差
错误处理与日志不能省
真实环境中，JSON格式错误、字段缺失、类型错配比比皆是：
- 解析失败时，用
cJSON_GetErrorPtr()获取出错位置，写进日志便于定位 - 提取字段前，始终检查
value != NULL和value->type == cJSON_String（或其他预期类型） - 对整数、布尔等类型，提供独立封装函数（如
json_extract_int），内部做valueint或valuebool判定，不靠调用方猜
