nlohmann/json被广泛使用的原因包括:①单头文件无需编译,直接包含即可使用;②语法简洁直观,类似#%#$#%@%@%$#%$#%#%#$%@_23eeeb4347bdd26bfc++6b7ee9a3b755dd和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 <iostream> #include <fstream> #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互转。
基本上就这些。刚开始用的时候可能对语法不太熟,但一旦写过几次,就会觉得挺自然的。