nlohmann/json 可自动将 std::vector 或 C 数组转为 JSON 数组,但裸指针会误转为 bool;自定义类型需在对应命名空间重载 to_json;大数组应预分配或流式 dump 优化性能;浮点数需注意精度、NaN 处理及跨平台一致性。

用 nlohmann/json 直接构造 JSON 数组最简单
如果你的数组是 std::vector 或 C 风格数组(已知长度),nlohmann/json 库能自动推导并序列化为 JSON 数组,无需手动遍历。它对 std::vector、std::array、原生数组(配合 std::begin/std::end)都支持隐式转换。
常见错误是直接传入裸指针(如 int*),这会触发指针转 bool 的隐式转换,结果变成 true 或 false,而不是数组内容。
- ✅ 正确:用
std::vector<int>{1, 2, 3}构造nlohmann::json - ✅ 正确:对 C 数组用
nlohmann::json(arr, arr + N)(N 必须显式提供) - ❌ 错误:传
int* ptr = arr;给nlohmann::json(ptr)
示例:
#include <nlohmann/json.hpp>
using json = nlohmann::json;
<p>std::vector<double> data = {3.14, 2.71, 1.41};
json j = data; // 自动转为 [3.14, 2.71, 1.41]
std::string s = j.dump(); // 得到字符串</p>处理非标准容器或自定义结构体数组
nlohmann/json 不会自动识别自定义类数组,必须显式定义 to_json 重载函数。否则编译报错:no matching function for call to 'to_json'。
立即学习“C++免费学习笔记(深入)”;
关键点在于:重载函数必须在自定义类型所在命名空间内(ADL 查找要求),且参数顺序固定为 (json&, const YourType&)。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 若结构体在全局命名空间,
to_json也必须在全局 - 若结构体在
namespace ns { struct A {}; }中,to_json必须也在ns内 - 对数组本身(如
A arr[3]),仍需用json(arr, arr + 3)或先转std::vector
示例(结构体内联定义):
struct Point { double x, y; };
void to_json(json& j, const Point& p) {
j = json{{"x", p.x}, {"y", p.y}};
}
// 使用:
Point pts[] = {{1.0, 2.0}, {3.0, 4.0}};
json j(pts, pts + 2); // → [{"x":1.0,"y":2.0}, {"x":3.0,"y":4.0}]
性能敏感场景:避免重复内存拷贝
nlohmann::json 默认按值传递、深度拷贝。对大数组(如百万级浮点数),直接赋值 j = vec 会触发两次拷贝:一次进 JSON 内部,一次调用 dump() 生成字符串时再拷贝。
可选优化路径:
- 用
json::array()预分配容量,再用push_back插入(减少内部 realloc) - 若只需写入文件,用
dump(2, false, json::error_handler_t::strict, std::ofstream&)的流式接口(需 patch 或 v3.11.2+) - 极端情况:改用
simdjson+ 手写序列化逻辑(绕过通用 JSON 对象模型,但失去易用性)
注意:dump() 的缩进参数(如 dump(2))会显著增加输出体积和时间,生产环境建议用 dump(-1)(无缩进)。
跨平台兼容性要注意浮点数精度和 NaN 处理
nlohmann/json 默认将 double 输出为最多 17 位有效数字,符合 IEEE 754 双精度可逆表示,但某些旧系统 JSON 解析器可能截断。更隐蔽的问题是 NaN、inf:默认序列化为 null,而非 JSON 标准外的字符串(如 "NaN")。
- 启用
json::allow_exceptions = false后,遇到 NaN 会抛异常(若未禁用异常) - 需保留 NaN 语义时,必须提前替换:如用
std::isnan(x) ? json("NaN") : x - Windows 下
std::to_chars实现较晚,v3.11.2 前可能回退到std::sprintf,影响浮点格式一致性
这个细节在科学计算或金融数据导出时容易被忽略——看着输出正常,但下游解析后数值已偏移。

















