nlohmann/json 完整指南C 单头文件 JSON 解析与序列化库从集成到生产【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json当 C 服务需要读取配置文件或处理 HTTP 响应时JSON 的解析与序列化往往是最先要解决的集成项。nlohmann/json 是一个 C 单头文件 JSON 库包含 json.hpp 后即可创建、解析和输出 JSON 对象无需改动构建系统。项目速览nlohmann/jsonJSON for Modern C是面向现代 C 的 JSON 解析与序列化库核心是一个零依赖的纯 C11 头文件 single_include/nlohmann/json.hpp。它解决的问题是不引入构建系统改动、不手写解析器就能在任何 C 项目里获得一个完整的 JSON 一等数据类型。质量方面有量化记录tests/src/ 下 90 多个单元测试文件官方声称代码覆盖率 100%并接入 Google OSS-Fuzz 持续做模糊测试。项目信息许可证MIT当前版本3.12.0开发语言C纯 C11header-only无第三方依赖编译器要求GCC 4.8 / Clang / MSVCC11 起步C17 解锁结构化绑定等写法集成方式拷贝单头文件、CMakefind_package(nlohmann_json 3.12.0)或 vcpkg / Conan / Homebrew 核心价值JSON 作为一等数据类型对使用者意味着不必学一套新 API会std::map和std::vector就会用它。赋值、下标、范围 for 迭代开箱即用赋值时不需要声明值是对象还是数组类型自动推断。json j; j[pi] 3.141; j[list] {1, 0, 2}; std::cout j.dump() std::endl; // {list:[1,0,2],pi:3.141}单头文件零依赖集成对使用者意味着把一个 json.hpp 拷进 include 目录即可接入不碰 CMake、不引入依赖冲突升级版本等价于替换文件。唯一的语言要求是 C11所以老项目如 GCC 4.8 环境也能直接用不需要调编译器参数。内置二进制格式与 Pointer / Patch除文本 JSON 外库自带 BSON、CBOR、MessagePack、UBJSON、BJData 五种二进制格式的to_/from_API以及 JSON Pointer 定位和 JSON Patch 差量应用。对使用者意味着通信协议要紧凑二进制、或需要按 RFC 6902 应用增量补丁时不必再为同一项目搭配第二个库。auto buf json::to_msgpack(j); json j2 json::from_msgpack(buf);最小上手路径最短路径是 clone 仓库后拷贝单头文件一条编译命令即可运行# 1. 获取源码也可用 vcpkg install nlohmann-json 等包管理器 git clone https://gitcode.com/GitHub_Trending/js/json # 2. 将 single_include/nlohmann/json.hpp 拷入项目 include/ 目录 // main.cpp #include iostream #include nlohmann/json.hpp using json nlohmann::json; int main() { json j {{message, hello}, {values, {1, 2, 3}}}; std::cout j.dump(4) std::endl; } // 3. 编译运行g -stdc11 main.cpp -o main 场景演示当读写配置文件时输入是磁盘上的 config.json操作是流式解析加带默认值读取输出是美化后的文件std::ifstream f(config.json); json config; f config; // 解析整个文件 int port config.value(port, 8080); // 键缺失时回退默认值 std::ofstream o(config.pretty.json); o std::setw(4) config; // 按 4 空格缩进写回当序列化自定义类型时输入是结构体操作是定义一对to_json/from_jsonADL 自动发现输出是双向透明的 JSONstruct Person { std::string name; int age; }; void to_json(json j, const Person p) { j json{{name, p.name}, {age, p.age}}; } void from_json(const json j, Person p) { j.at(name).get_to(p.name); j.at(age).get_to(p.age); } json j Person{Alice, 30}; // 自动序列化 Person p j.getPerson(); // 自动反序列化实操建议性能在 tests/reports/2016-09-09-nativejson_benchmark/ 的 2016 年解析耗时数据中nlohmannC11为 72ms处于中游约为 RapidJSON8ms的 1/9。官方设计目标明确把开发效率排在解析速度之前建议高吞吐日志或流式大文件场景先做基准测试再决定。错误处理json::parse默认对非法输入抛parse_error处理不可信输入时建议改用json::parse(s, nullptr, false)不抛异常再检查is_discarded()。键缺失时用value(key, 默认值)或抛异常的at()少用静默语义的operator[]。版本选择当前版本 3.12.0C11 是底线项目已是 C17 时可用结构化绑定遍历对象for (auto [k, v] : o.items())代码更短。常见坑写json j 字符串字面量只是存了一个 JSON 字符串并不会解析需要加_json字面量后缀或显式调用json::parse。另外对 null 值做j[key]会自动把 null 转成对象只读访问请用at()。编译时长单头文件在多个编译单元里#include会显著拉长编译时间建议用预编译头缓解或在 C20 下启用NLOHMANN_JSON_BUILD_MODULES以模块方式编译src/modules/ 已提供模块接口。客观对比与两类常见替代方案的对比性能数据取自同一份 2016 年 nativejson-benchmark 报告非最新硬件维度nlohmann/jsonRapidJSONJsonCpp集成成本单头文件零配置拷贝即用header-only但 DOM/SAX 双模式与分配器配置需要额外理解需构建静态库并接入 CMake功能范围解析/序列化 5 种二进制格式 Pointer/Patch/Merge Patch ADL 自定义类型DOM 与 SAX 双模式、流式处理二进制格式需另选解析/序列化与 Schema 校验无内置 JSON Patch性能定位解析 72ms中游明显慢于 RapidJSON 的 8ms解析速度居同类前列约 166ms慢于 nlohmann文档与社区每个 API 配独立示例docs/mkdocs/docs/examples/90 单测、OSS-Fuzz 常态化文档完善社区活跃文档较简维护节奏偏慢同一份报告里 nlohmann 的解析一致性通过率 96%与 RapidJSON 基本处于同一梯队。解析耗时对比图如下nlohmann 为 72ms 一档2016 年 nativejson-benchmark 各 C JSON 库解析耗时对比图.png)选型结论适合把开发效率放在第一位的项目——工具、服务、游戏后端、能在 GCC 4.8 上编译的环境需要 JSON 加二进制格式加 Pointer/Patch 一套齐活的场景不想动构建系统的老项目。不适合对解析吞吐或内存占用敏感的链路高频日志、超大文件流式解析严格限制编译时长的代码库需要内置 JSON Schema 校验的场景。如果你的首要目标是当天拿掉 JSON 支持、且单条消息的解析延迟不构成瓶颈nlohmann/json 是集成风险较低的选择。关键资源README.mdQuick reference 与完整示例、docs/mkdocs/docs/examples/可独立编译的示例源码、tests/src/单元测试全集。【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
nlohmann/json 完整指南C 单头文件 JSON 解析与序列化库从集成到生产【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json当 C 服务需要读取配置文件或处理 HTTP 响应时JSON 的解析与序列化往往是最先要解决的集成项。nlohmann/json 是一个 C 单头文件 JSON 库包含 json.hpp 后即可创建、解析和输出 JSON 对象无需改动构建系统。项目速览nlohmann/jsonJSON for Modern C是面向现代 C 的 JSON 解析与序列化库核心是一个零依赖的纯 C11 头文件 single_include/nlohmann/json.hpp。它解决的问题是不引入构建系统改动、不手写解析器就能在任何 C 项目里获得一个完整的 JSON 一等数据类型。质量方面有量化记录tests/src/ 下 90 多个单元测试文件官方声称代码覆盖率 100%并接入 Google OSS-Fuzz 持续做模糊测试。项目信息许可证MIT当前版本3.12.0开发语言C纯 C11header-only无第三方依赖编译器要求GCC 4.8 / Clang / MSVCC11 起步C17 解锁结构化绑定等写法集成方式拷贝单头文件、CMakefind_package(nlohmann_json 3.12.0)或 vcpkg / Conan / Homebrew 核心价值JSON 作为一等数据类型对使用者意味着不必学一套新 API会std::map和std::vector就会用它。赋值、下标、范围 for 迭代开箱即用赋值时不需要声明值是对象还是数组类型自动推断。json j; j[pi] 3.141; j[list] {1, 0, 2}; std::cout j.dump() std::endl; // {list:[1,0,2],pi:3.141}单头文件零依赖集成对使用者意味着把一个 json.hpp 拷进 include 目录即可接入不碰 CMake、不引入依赖冲突升级版本等价于替换文件。唯一的语言要求是 C11所以老项目如 GCC 4.8 环境也能直接用不需要调编译器参数。内置二进制格式与 Pointer / Patch除文本 JSON 外库自带 BSON、CBOR、MessagePack、UBJSON、BJData 五种二进制格式的to_/from_API以及 JSON Pointer 定位和 JSON Patch 差量应用。对使用者意味着通信协议要紧凑二进制、或需要按 RFC 6902 应用增量补丁时不必再为同一项目搭配第二个库。auto buf json::to_msgpack(j); json j2 json::from_msgpack(buf);最小上手路径最短路径是 clone 仓库后拷贝单头文件一条编译命令即可运行# 1. 获取源码也可用 vcpkg install nlohmann-json 等包管理器 git clone https://gitcode.com/GitHub_Trending/js/json # 2. 将 single_include/nlohmann/json.hpp 拷入项目 include/ 目录 // main.cpp #include iostream #include nlohmann/json.hpp using json nlohmann::json; int main() { json j {{message, hello}, {values, {1, 2, 3}}}; std::cout j.dump(4) std::endl; } // 3. 编译运行g -stdc11 main.cpp -o main 场景演示当读写配置文件时输入是磁盘上的 config.json操作是流式解析加带默认值读取输出是美化后的文件std::ifstream f(config.json); json config; f config; // 解析整个文件 int port config.value(port, 8080); // 键缺失时回退默认值 std::ofstream o(config.pretty.json); o std::setw(4) config; // 按 4 空格缩进写回当序列化自定义类型时输入是结构体操作是定义一对to_json/from_jsonADL 自动发现输出是双向透明的 JSONstruct Person { std::string name; int age; }; void to_json(json j, const Person p) { j json{{name, p.name}, {age, p.age}}; } void from_json(const json j, Person p) { j.at(name).get_to(p.name); j.at(age).get_to(p.age); } json j Person{Alice, 30}; // 自动序列化 Person p j.getPerson(); // 自动反序列化实操建议性能在 tests/reports/2016-09-09-nativejson_benchmark/ 的 2016 年解析耗时数据中nlohmannC11为 72ms处于中游约为 RapidJSON8ms的 1/9。官方设计目标明确把开发效率排在解析速度之前建议高吞吐日志或流式大文件场景先做基准测试再决定。错误处理json::parse默认对非法输入抛parse_error处理不可信输入时建议改用json::parse(s, nullptr, false)不抛异常再检查is_discarded()。键缺失时用value(key, 默认值)或抛异常的at()少用静默语义的operator[]。版本选择当前版本 3.12.0C11 是底线项目已是 C17 时可用结构化绑定遍历对象for (auto [k, v] : o.items())代码更短。常见坑写json j 字符串字面量只是存了一个 JSON 字符串并不会解析需要加_json字面量后缀或显式调用json::parse。另外对 null 值做j[key]会自动把 null 转成对象只读访问请用at()。编译时长单头文件在多个编译单元里#include会显著拉长编译时间建议用预编译头缓解或在 C20 下启用NLOHMANN_JSON_BUILD_MODULES以模块方式编译src/modules/ 已提供模块接口。客观对比与两类常见替代方案的对比性能数据取自同一份 2016 年 nativejson-benchmark 报告非最新硬件维度nlohmann/jsonRapidJSONJsonCpp集成成本单头文件零配置拷贝即用header-only但 DOM/SAX 双模式与分配器配置需要额外理解需构建静态库并接入 CMake功能范围解析/序列化 5 种二进制格式 Pointer/Patch/Merge Patch ADL 自定义类型DOM 与 SAX 双模式、流式处理二进制格式需另选解析/序列化与 Schema 校验无内置 JSON Patch性能定位解析 72ms中游明显慢于 RapidJSON 的 8ms解析速度居同类前列约 166ms慢于 nlohmann文档与社区每个 API 配独立示例docs/mkdocs/docs/examples/90 单测、OSS-Fuzz 常态化文档完善社区活跃文档较简维护节奏偏慢同一份报告里 nlohmann 的解析一致性通过率 96%与 RapidJSON 基本处于同一梯队。解析耗时对比图如下nlohmann 为 72ms 一档2016 年 nativejson-benchmark 各 C JSON 库解析耗时对比图.png)选型结论适合把开发效率放在第一位的项目——工具、服务、游戏后端、能在 GCC 4.8 上编译的环境需要 JSON 加二进制格式加 Pointer/Patch 一套齐活的场景不想动构建系统的老项目。不适合对解析吞吐或内存占用敏感的链路高频日志、超大文件流式解析严格限制编译时长的代码库需要内置 JSON Schema 校验的场景。如果你的首要目标是当天拿掉 JSON 支持、且单条消息的解析延迟不构成瓶颈nlohmann/json 是集成风险较低的选择。关键资源README.mdQuick reference 与完整示例、docs/mkdocs/docs/examples/可独立编译的示例源码、tests/src/单元测试全集。【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
