告别手动拼接字符串：用cJSON库在C语言里优雅地生成JSON数据（附完整代码）

告别手动拼接字符串：用cJSON库在C语言里优雅地生成JSON数据（附完整代码）

在嵌入式系统和网络通信开发中，处理JSON数据是家常便饭。很多C程序员习惯用sprintf和字符串拼接来构造JSON，直到某天凌晨三点调试时发现，因为少写了一个反斜杠导致整个系统崩溃。这种经历让我彻底转向了cJSON——一个轻量级但功能完整的C语言JSON处理库。

cJSON不仅解决了手动拼接带来的转义噩梦，还通过类型安全的API彻底杜绝了内存越界风险。下面我们将从实际项目角度，演示如何用cJSON构建复杂的嵌套JSON结构，特别适合设备状态上报、配置管理等场景。

1. 为什么必须放弃手动拼接JSON

在物联网设备开发中，我们经常需要生成这样的状态报告：

{
  "device": "ESP32-C3",
  "status": {
    "temperature": 42.5,
    "humidity": 68,
    "errors": ["E002", "E043"]
  },
  "timestamp": 1659326400
}

手动拼接的代码通常会写成这样：

char buffer[256];
sprintf(buffer, "{\"device\":\"%s\",\"status\":{\"temperature\":%.1f,\"humidity\":%d,"
         "\"errors\":[\"%s\",\"%s\"]},\"timestamp\":%ld}", 
         device_name, temp, humi, err1, err2, time);

这种写法至少有三大致命缺陷：

1. 转义符地狱：每个引号都需要转义，稍不留神就会出错
2. 缓冲区溢出：无法预判最终字符串长度，可能引发内存越界