cJSON实战：从天气预报API解析复杂嵌套JSON的完整指南
天气预报应用已经成为现代人日常生活不可或缺的工具。当我们调用天气API时，服务器通常会返回结构复杂的JSON数据，包含多日预报、空气质量指数等嵌套信息。对于C语言开发者来说，如何高效解析这些数据成为必须掌握的技能。本文将带你使用轻量级cJSON库，一步步拆解真实天气API返回的复杂JSON结构。
1. 环境准备与基础配置
1.1 获取cJSON库
cJSON作为一款超轻量级的C语言JSON解析器，其源代码仅需两个文件（cJSON.h和cJSON.c），非常适合嵌入式系统和资源受限环境。获取方式有两种：
直接下载源码：
wget https://github.com/DaveGamble/cJSON/archive/master.zip unzip master.zip包管理器安装（以Ubuntu为例）：
sudo apt-get install libcjson-dev
1.2 项目集成
将cJSON添加到你的C项目非常简单：
- 复制cJSON.h和cJSON.c到项目目录
- 在源文件中包含头文件：
#include "cJSON.h" - 编译时链接cJSON.c：
gcc your_program.c cJSON.c -o weather_parser
提示：建议开启编译器优化选项（如-O2）以获得更好的解析性能。
2. 核心API函数精要
cJSON虽然小巧，但提供了完整的JSON处理功能。以下是解析天气数据时最常用的几个函数：
| 函数原型 | 作用描述 | 返回值说明 |
|---|---|---|
cJSON* cJSON_Parse(const char*) | 解析JSON字符串并构建内存树 | 成功返回根节点指针，失败返回NULL |
cJSON* cJSON_GetObjectItem(cJSON*, const char*) | 获取对象中的指定字段 | 存在返回节点指针，否则NULL |
cJSON* cJSON_GetArrayItem(cJSON*, int) | 获取数组指定索引的元素 | 有效索引返回元素指针，否则NULL |
int cJSON_GetArraySize(cJSON*) | 获取数组元素个数 | 返回数组长度 |
char* cJSON_Print(cJSON*) | 将cJSON节点转为JSON字符串 | 返回堆分配字符串，需手动释放 |
void cJSON_Delete(cJSON*) | 释放整个JSON树内存 | 无 |
关键点记忆：
- 所有通过cJSON创建的对象最终都需要用
cJSON_Delete释放 cJSON_Print生成的字符串需要手动free- 每次访问节点后都应检查返回值是否为NULL
3. 天气预报JSON结构深度解析
典型的天气API响应包含多层嵌套结构。以下是一个简化版的和风天气API响应示例：
{ "city": "北京", "updateTime": "2023-06-15T16:30+08:00", "daily": [ { "date": "2023-06-15", "tempMax": "32", "tempMin": "22", "iconDay": "100", "textDay": "晴", "windDirDay": "东南风", "humidity": "45" }, { "date": "2023-06-16", "tempMax": "34", "tempMin": "24", "iconDay": "101", "textDay": "多云", "windDirDay": "南风", "humidity": "50" } ], "aqi": { "value": "78", "level": "良", "pm25": "56" } }3.1 结构特征分析
- 顶层对象：包含城市、更新时间等基本信息
- daily数组：存储多日预报数据，每个元素是一个完整天气对象
- 嵌套对象：如aqi包含多个空气质量相关字段
4. 实战解析步骤详解
4.1 基础解析流程
void parse_weather(const char* json_str) { cJSON* root = cJSON_Parse(json_str); if (!root) { printf("解析错误: %s\n", cJSON_GetErrorPtr()); return; } // 提取城市信息 cJSON* city = cJSON_GetObjectItem(root, "city"); if (cJSON_IsString(city)) { printf("城市: %s\n", city->valuestring); } // 后续解析代码... cJSON_Delete(root); }4.2 处理嵌套数组
解析daily数组需要特别注意数组遍历：
cJSON* daily = cJSON_GetObjectItem(root, "daily"); if (cJSON_IsArray(daily)) { int day_count = cJSON_GetArraySize(daily); printf("获取到%d天预报数据\n", day_count); for (int i = 0; i < day_count; i++) { cJSON* day = cJSON_GetArrayItem(daily, i); cJSON* date = cJSON_GetObjectItem(day, "date"); cJSON* tempMax = cJSON_GetObjectItem(day, "tempMax"); if (cJSON_IsString(date) && cJSON_IsString(tempMax)) { printf("日期: %s, 最高温: %s℃\n", date->valuestring, tempMax->valuestring); } } }4.3 深度嵌套对象访问
对于aqi这样的多层嵌套对象，可以采用链式访问：
cJSON* aqi = cJSON_GetObjectItem(root, "aqi"); if (aqi) { cJSON* pm25 = cJSON_GetObjectItem(aqi, "pm25"); if (cJSON_IsString(pm25)) { printf("PM2.5浓度: %s\n", pm25->valuestring); } }5. 高级技巧与错误处理
5.1 安全访问模式
为避免频繁的NULL检查，可以封装安全访问函数：
const char* safe_get_string(cJSON* obj, const char* key) { cJSON* item = cJSON_GetObjectItem(obj, key); return (item && cJSON_IsString(item)) ? item->valuestring : "N/A"; } // 使用示例 printf("天气状况: %s\n", safe_get_string(day, "textDay"));5.2 内存管理最佳实践
cJSON需要特别注意内存管理：
- 创建-删除配对：每个
cJSON_Parse必须对应一个cJSON_Delete - 打印字符串释放：
cJSON_Print返回的字符串需要free - 错误处理路径：所有错误分支都要确保资源释放
void safe_parse(const char* json_str) { cJSON* root = cJSON_Parse(json_str); if (!root) return; char* json_text = cJSON_Print(root); if (json_text) { printf("格式化输出:\n%s\n", json_text); free(json_text); } cJSON_Delete(root); }5.3 性能优化技巧
处理大型JSON时可以考虑：
- 选择性解析：只提取需要的字段，减少内存占用
- 缓冲区复用：重复使用解析缓冲区
- 预分配内存：对于已知大小的数组，可以预分配存储空间
6. 完整示例：天气预报解析器
下面是一个整合所有技术的完整示例：
#include <stdio.h> #include <stdlib.h> #include "cJSON.h" void parse_weather_response(const char* response) { cJSON* root = cJSON_Parse(response); if (!root) { fprintf(stderr, "JSON解析失败\n"); return; } // 解析基础信息 printf("=== 天气预报 ===\n"); printf("城市: %s\n", safe_get_string(root, "city")); printf("更新时间: %s\n", safe_get_string(root, "updateTime")); // 解析每日预报 cJSON* daily = cJSON_GetObjectItem(root, "daily"); if (cJSON_IsArray(daily)) { printf("\n未来预报:\n"); int count = cJSON_GetArraySize(daily); for (int i = 0; i < count; i++) { cJSON* day = cJSON_GetArrayItem(daily, i); printf("[%s] %s, 温度: %s~%s℃, 湿度: %s%%\n", safe_get_string(day, "date"), safe_get_string(day, "textDay"), safe_get_string(day, "tempMin"), safe_get_string(day, "tempMax"), safe_get_string(day, "humidity")); } } // 解析空气质量 cJSON* aqi = cJSON_GetObjectItem(root, "aqi"); if (aqi) { printf("\n空气质量: %s (PM2.5: %s)\n", safe_get_string(aqi, "level"), safe_get_string(aqi, "pm25")); } cJSON_Delete(root); }在实际项目中处理真实天气API数据时，有三个常见陷阱需要特别注意：首先是忘记检查API返回的HTTP状态码，直接尝试解析响应体；其次是未处理字段可能缺失的情况，导致程序崩溃；最后是忽略时区转换，特别是处理国际天气数据时。我曾在项目中因为时区问题导致显示时间错误8小时，后来添加了专门的时区转换函数才解决这个问题。
