nlohmann/json是纯头文件库，正确引入方式是下载single_include/nlohmann/json.hpp放入项目include目录，用#include <nlohmann/json.hpp>包含，并确保编译器启用C++11或更高标准。
如何在C++项目中正确引入nlohmann/json头文件
不需要编译安装，nlohmann/json是纯头文件库，直接包含即可。但必须确保编译器支持C++11或更高版本（默认启用std::string、std::vector等特性），否则会报大量模板推导失败错误。
常见做法是把nlohmann/json.hpp下载后放到项目include路径下，然后写：
#include <nlohmann/json.hpp> using json = nlohmann::json;
- 不要用
#include "json.hpp"（除非你把它放在当前目录） - 不推荐全局
using namespace nlohmann，容易和项目其他json类型冲突 - 如果用CMake，可配合
find_package(nlohmann_json REQUIRED)（需提前用vcpkg/conan安装）
解析JSON字符串时遇到"parse error"怎么办
绝大多数parse error不是语法问题，而是输入为空、含BOM、混入控制字符或编码非UTF-8。nlohmann/json严格要求输入为UTF-8字节流，不自动检测或转换编码。
安全解析建议：
立即学习“C++免费学习笔记（深入）”；
- 先检查
str.empty()，空字符串直接抛异常 - 用
std::string_view传参避免多余拷贝，但确保源字符串生命周期足够长 - 捕获
nlohmann::json::parse_error并打印e.what()和e.byte定位出错位置 - Windows记事本保存的JSON常带UTF-8 BOM（
\xEF\xBB\xBF），需手动跳过
示例：
try {
auto j = json::parse(str);
} catch (const json::parse_error& e) {
std::cerr << "JSON parse error at byte " << e.byte << ": " << e.what() << "\n";
}
访问嵌套对象或数组时如何避免segmentation fault
nlohmann/json的operator[]对不存在的键返回null值，但解引用null会触发断言（debug模式）或未定义行为（release模式）。不能假设字段一定存在。
安全访问方式有三种：
- 用
at("key")：抛out_of_range异常，适合已知结构且想快速失败 - 用
value("key", default_val)：提供默认值，适合可选字段 - 先用
contains("key")判断，再访问；或用j["key"].is_null()检查
数组越界同理：j[i]不检查索引范围，应先确认j.is_array() && i < j.size()。
为什么从JSON提取int有时得到0或溢出
JSON规范没有整型/浮点型区分，所有数字都按double解析。nlohmann默认用double存储数字，调用j["num"].get<int>()会强制转换，不检查溢出。
后果包括：
- 大整数（如
9223372036854775807）转int变成负数或0 - 小数（如
3.14）转int直接截断为3，无警告 - 正确做法是用
get<long long>()或get<int64_t>()接大整数，或用is_number_integer()预检
例如：
if (j["id"].is_number_integer()) {
int64_t id = j["id"].get<int64_t>();
}
解析深层嵌套或含混合类型的数据时，最容易忽略的是类型断言——比如把字符串当数字用get<int>()，或者把null当对象解引用。宁可多写一行is_xxx()检查，也别依赖文档里“这个字段总是存在”的承诺。 
