nlohmann/json被广泛使用的原因包括：①单头文件无需编译，直接包含即可使用；②语法简洁直观，类似python和javascript；③支持c++11及以上标准，适配现代c++项目；④社区活跃、文档完善，问题易解决。安装方式主要有两种：①通过vcpkg或conan等包管理器安装；②从github下载json.hpp文件并加入项目。读写json文件流程简单：①写入时用ofstream结合j.dump(4)格式化输出到文件；②读取时用ifstream加载文件内容到json对象，并可通过j["key"]访问字段，建议先判断字段是否存在。注意事项包括：①类型不匹配可能导致崩溃，应使用try-catch处理异常；②确保文件为utf-8编码以避免中文乱码；③嵌套结构可层层访问，如j"user"["city"]；④可通过重载to_json()和from_json()实现自定义类的序列化。
在C++中处理JSON文件，最常用的库是 nlohmann/json。它是一个轻量级、功能齐全的JSON库，完全用C++编写，使用起来非常方便，尤其适合现代C++项目。
为什么选 nlohmann/json？
这个库有几个显著优点：
- 头文件仅需一个：不需要编译，直接包含即可使用。
- 语法简洁直观：和Python、JavaScript处理JSON的方式很像。
- 支持C++11及以上标准：如果你的项目已经用了现代C++，它能很好地融入。
- 社区活跃、文档完善：遇到问题容易找到答案。
如果你只是想快速读写JSON数据，这个库基本能满足需求。
立即学习“C++免费学习笔记（深入）”；
如何安装和引入？
因为这是一个纯头文件库，所以不需要额外编译安装。你可以通过以下几种方式获取：
- 使用包管理器（如vcpkg或conan）安装
- 直接从GitHub下载
json.hpp
文件并加入项目
举个简单的例子：
#include#include #include "json.hpp" // 把下载好的json.hpp放在这儿 int main() { // 创建一个JSON对象 nlohmann::json j; j["name"] = "Alice"; j["age"] = 25; // 转成字符串输出 std::cout << j.dump(4) << std::endl; // 格式化缩进4格输出 }
这样就可以开始构造JSON数据了。
怎么读写JSON文件？
操作流程其实很简单，主要就是把文件内容加载到JSON对象里，或者反过来。
写入JSON文件：
std::ofstream o("output.json");
o << j.dump(4); // 把上面定义的j写进去，并格式化读取JSON文件：
std::ifstream i("input.json");
nlohmann::json j;
i >> j; // 自动解析内容
// 取值也很简单
std::string name = j["name"];
int age = j["age"];注意几点：
- 文件路径要正确，否则会读空
- JSON结构要匹配访问方式，比如数组要用
[]
索引 - 如果字段可能不存在，建议先判断
if (j.contains("key"))
常见问题和小技巧
- 类型不匹配导致崩溃：比如试图从字符串字段读出整数，程序可能会抛异常。可以加try-catch避免。
- 中文乱码问题：默认是UTF-8编码，确保你的JSON文件也是UTF-8保存。
-
嵌套结构处理：可以层层访问，例如
j["user"]["address"]["city"]
-
自定义类序列化：可以通过重载
to_json()
和from_json()
方法来实现自己的类与JSON互转。
基本上就这些。刚开始用的时候可能对语法不太熟，但一旦写过几次，就会觉得挺自然的。
