零依赖的 C JSON 库nlohmann/json 三分钟上手【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json想象一个场景你的 C 服务收到一份 200KB 的接口返回而你只想取出第三层里的一个字段。传统做法得手动解析字符串、管理内存一不小心就踩坑。今天要讲的nlohmann/json全称 JSON for Modern C专门解决这类麻烦它把整个 JSON 库压缩进一个头文件零依赖、无构建配置让你像写 Python 字典一样自然地读写 JSON。它是什么一句话定位nlohmann/json 是一个用现代 C 写的、单头文件、零依赖的 JSON 库把“解析、修改、序列化、二进制格式”这些活全包了。维度说明定位场景配置解析、API 数据交换、结构化存储依赖形态单个头文件json.hpp无需链接库协议MIT 许可商业项目可自由使用Star 数约 50kGitHub 上长期高星项目它的核心思路是让 JSON 成为 C 里的一等公民——你不再需要记一堆 C 风格 API而是用熟悉的[]、push_back、迭代器来操作数据。三分钟上手安装最快的一步就是拿到那个头文件。你可以直接把json.hpp放进项目包含它就能用# 直接把单头文件 vendoring 到项目示例 cp json.hpp myproject/third_party/nlohmann/下面是完整的最小可运行代码10 行以内就能跑通解析、修改、输出全流程#include nlohmann/json.hpp #include iostream using json nlohmann::json; int main() { json j {{name, Niels}, {happy, true}}; j[pi] 3.141; // 像字典一样加字段 std::cout j.dump(4) std::endl; }运行后你会看到一份整齐缩进的输出{ happy: true, name: Niels, pi: 3.141 }只要这一句dump()数据就变成了可读的 JSON 文本整个入门过程到此结束。核心用法速览创建 JSON就像建一个 Python 字典直接用花括号初始化嵌套对象、数组都写在里面。json j { {list, {1, 0, 2}}, {object, {{currency, USD}, {value, 42.99}}} };读取与修改用[]取值、赋值用迭代器遍历C17 还能直接对键值对做结构化绑定读起来非常顺。for (auto [key, value] : j.items()) { std::cout key : value \n; }存取与传输dump()负责序列化parse()负责反序列化再配合std::ofstream/std::ifstream就能直接读写文件不用额外处理字节。std::string s j.dump(); // 序列化成字符串 json j2 json::parse(s); // 从字符串解析回来这三种操作覆盖了日常 90% 的场景剩下的都是它们的排列组合。值得了解的 3 个进阶能力下面三个能力是从日常工具跃升到“能上生产”的关键。1. JSON Pointer 精确定位用类似路径的字符串/foo/bar直接戳到深层节点比一层层写[]清晰得多也适合做“按路径取字段”的通用工具。int x j.at(/foo/bar_json_pointer).getint();2. 自定义类型自动序列化为你的结构体各写一对to_json/from_json之后json j myStruct;就能双向转换框架替你处理字段映射。void to_json(json j, const Person p) { j json{{name, p.name}, {age, p.age}}; }3. 多二进制格式互转除了文本 JSON它还内置 CBOR、MessagePack、BSON、UBJSON 等格式一行代码就能在它们之间切换特别适合跨语言传输。std::vectorstd::uint8_t c json::to_cbor(j);工程化集成三种集成方式各有取舍按你的工程习惯挑一个即可。集成方式做法适用情况直接 vendoring 头文件把json.hpp拷进仓库追求零依赖、离线可用CMakeFetchContent或find_package有构建系统想统一版本包管理器vcpkg / Conan / NuGet 安装跨多项目复用CMake 集成的典型写法很短find_package(nlohmann_json 3.12 REQUIRED) target_link_libraries(myapp PRIVATE nlohmann_json::nlohmann_json)更多接入细节包括不同平台与生成器可以参考项目自带的 docs/ 文档。如何选择和另外两个常见库放在一起比差异主要体现在集成成本和 API 上手速度上。维度nlohmann/jsonRapidJSONJsonCpp集成成本极低单头文件高需编译中API 易用性强类字典语法弱偏 C中功能广度广含二进制/Patch/Pointer偏解析中一句话建议除非你对极端解析性能有硬指标、愿意为此牺牲可读性否则 nlohmann/json 是大多数 C 项目里更省心、更好维护的选择。常见坑与注意事项这些是实战里最容易绊倒人的地方提前知道能省不少时间。警惕discarded状态用json::parse(…, nullptr, false)这类“静默解析”时失败会返回 discarded 值而不是抛异常记得先查is_discarded()。异常策略要统一默认解析失败会抛parse_error生产环境要么捕获处理要么关掉异常走 discarded 分支别两种模式混用。[]会静默创建键对象上j[不存在]会插入一个 null 键想“只读”请用at()或先contains()。数值转换可能溢出/失精度getT()在类型不匹配时抛异常跨类型取数前先确认源类型必要时用is_number_integer()判断。单头文件 ≠ 零编译时间头文件体量不小把它只放进必要的编译单元、别到处#include能明显缩短编译耗时。小结nlohmann/json 用单头文件、零依赖的形态把 C 里的 JSON 处理降到“几乎无感”的程度学习成本低、覆盖面却足够宽。它特别适合需要快速读写 JSON、又不想引入一堆构建配置的中小型 C 项目。随着对现代 C 特性支持的持续完善它在更多场景里都会是那个“默认选项”。核心源码与解析、序列化的实现都可以在项目的 src/ 目录里找到。【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 零依赖的 C++ JSON 库：nlohmann/json 三分钟上手
零依赖的 C JSON 库nlohmann/json 三分钟上手【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json想象一个场景你的 C 服务收到一份 200KB 的接口返回而你只想取出第三层里的一个字段。传统做法得手动解析字符串、管理内存一不小心就踩坑。今天要讲的nlohmann/json全称 JSON for Modern C专门解决这类麻烦它把整个 JSON 库压缩进一个头文件零依赖、无构建配置让你像写 Python 字典一样自然地读写 JSON。它是什么一句话定位nlohmann/json 是一个用现代 C 写的、单头文件、零依赖的 JSON 库把“解析、修改、序列化、二进制格式”这些活全包了。维度说明定位场景配置解析、API 数据交换、结构化存储依赖形态单个头文件json.hpp无需链接库协议MIT 许可商业项目可自由使用Star 数约 50kGitHub 上长期高星项目它的核心思路是让 JSON 成为 C 里的一等公民——你不再需要记一堆 C 风格 API而是用熟悉的[]、push_back、迭代器来操作数据。三分钟上手安装最快的一步就是拿到那个头文件。你可以直接把json.hpp放进项目包含它就能用# 直接把单头文件 vendoring 到项目示例 cp json.hpp myproject/third_party/nlohmann/下面是完整的最小可运行代码10 行以内就能跑通解析、修改、输出全流程#include nlohmann/json.hpp #include iostream using json nlohmann::json; int main() { json j {{name, Niels}, {happy, true}}; j[pi] 3.141; // 像字典一样加字段 std::cout j.dump(4) std::endl; }运行后你会看到一份整齐缩进的输出{ happy: true, name: Niels, pi: 3.141 }只要这一句dump()数据就变成了可读的 JSON 文本整个入门过程到此结束。核心用法速览创建 JSON就像建一个 Python 字典直接用花括号初始化嵌套对象、数组都写在里面。json j { {list, {1, 0, 2}}, {object, {{currency, USD}, {value, 42.99}}} };读取与修改用[]取值、赋值用迭代器遍历C17 还能直接对键值对做结构化绑定读起来非常顺。for (auto [key, value] : j.items()) { std::cout key : value \n; }存取与传输dump()负责序列化parse()负责反序列化再配合std::ofstream/std::ifstream就能直接读写文件不用额外处理字节。std::string s j.dump(); // 序列化成字符串 json j2 json::parse(s); // 从字符串解析回来这三种操作覆盖了日常 90% 的场景剩下的都是它们的排列组合。值得了解的 3 个进阶能力下面三个能力是从日常工具跃升到“能上生产”的关键。1. JSON Pointer 精确定位用类似路径的字符串/foo/bar直接戳到深层节点比一层层写[]清晰得多也适合做“按路径取字段”的通用工具。int x j.at(/foo/bar_json_pointer).getint();2. 自定义类型自动序列化为你的结构体各写一对to_json/from_json之后json j myStruct;就能双向转换框架替你处理字段映射。void to_json(json j, const Person p) { j json{{name, p.name}, {age, p.age}}; }3. 多二进制格式互转除了文本 JSON它还内置 CBOR、MessagePack、BSON、UBJSON 等格式一行代码就能在它们之间切换特别适合跨语言传输。std::vectorstd::uint8_t c json::to_cbor(j);工程化集成三种集成方式各有取舍按你的工程习惯挑一个即可。集成方式做法适用情况直接 vendoring 头文件把json.hpp拷进仓库追求零依赖、离线可用CMakeFetchContent或find_package有构建系统想统一版本包管理器vcpkg / Conan / NuGet 安装跨多项目复用CMake 集成的典型写法很短find_package(nlohmann_json 3.12 REQUIRED) target_link_libraries(myapp PRIVATE nlohmann_json::nlohmann_json)更多接入细节包括不同平台与生成器可以参考项目自带的 docs/ 文档。如何选择和另外两个常见库放在一起比差异主要体现在集成成本和 API 上手速度上。维度nlohmann/jsonRapidJSONJsonCpp集成成本极低单头文件高需编译中API 易用性强类字典语法弱偏 C中功能广度广含二进制/Patch/Pointer偏解析中一句话建议除非你对极端解析性能有硬指标、愿意为此牺牲可读性否则 nlohmann/json 是大多数 C 项目里更省心、更好维护的选择。常见坑与注意事项这些是实战里最容易绊倒人的地方提前知道能省不少时间。警惕discarded状态用json::parse(…, nullptr, false)这类“静默解析”时失败会返回 discarded 值而不是抛异常记得先查is_discarded()。异常策略要统一默认解析失败会抛parse_error生产环境要么捕获处理要么关掉异常走 discarded 分支别两种模式混用。[]会静默创建键对象上j[不存在]会插入一个 null 键想“只读”请用at()或先contains()。数值转换可能溢出/失精度getT()在类型不匹配时抛异常跨类型取数前先确认源类型必要时用is_number_integer()判断。单头文件 ≠ 零编译时间头文件体量不小把它只放进必要的编译单元、别到处#include能明显缩短编译耗时。小结nlohmann/json 用单头文件、零依赖的形态把 C 里的 JSON 处理降到“几乎无感”的程度学习成本低、覆盖面却足够宽。它特别适合需要快速读写 JSON、又不想引入一堆构建配置的中小型 C 项目。随着对现代 C 特性支持的持续完善它在更多场景里都会是那个“默认选项”。核心源码与解析、序列化的实现都可以在项目的 src/ 目录里找到。【免费下载链接】jsonJSON for Modern C项目地址: https://gitcode.com/GitHub_Trending/js/json创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考