nlohmann/json是纯头文件库，正确引入方式是下载single_include/nlohmann/json.hpp放入项目include目录，用#include 包含，并确保编译器启用c++11或更高标准。
如何在C++项目中正确引入nlohmann/json头文件
不需要编译安装，nlohmann/json是纯头文件库，直接包含即可。但必须确保编译器支持C++11或更高版本（默认启用std::string、std::vector等特性），否则会报大量模板推导失败错误。
常见做法是把nlohmann/json.hpp下载后放到项目include路径下，然后写：
#include <nlohmann> using json = nlohmann::json; </nlohmann>
- 不要用
#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字节流，不自动检测或转换编码。
安全解析建议：
- 先检查
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
<h3>访问嵌套对象或数组时如何避免segmentation fault</h3>
<p>nlohmann/json的<code>operator[]</code>对不存在的键返回null值，但解引用null会触发断言（debug模式）或未定义行为（release模式）。不能假设字段一定存在。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9063" title="chartjs-reporter"><img
src="https://img.php.cn/upload/skill/000/000/081/179239514984446.jpg" alt="chartjs-reporter" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9063" title="chartjs-reporter" class="overflowclass">chartjs-reporter</a>
<p class="overflowclass">此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。</p>
</div>
<a rel="nofollow" href="/xiazai/skill9063" title="chartjs-reporter" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<p>安全访问方式有三种：</p>
- 用
at("key")：抛out_of_range异常，适合已知结构且想快速失败 - 用
value("key", default_val)：提供默认值，适合可选字段 - 先用
contains("key")判断，再访问；或用j["key"].is_null()检查
数组越界同理：j[i]不检查索引范围，应先确认j.is_array() && i 。
为什么从JSON提取int有时得到0或溢出
JSON规范没有整型/浮点型区分，所有数字都按double解析。nlohmann默认用double存储数字，调用j["num"].get<int>()</int>会强制转换，不检查溢出。
后果包括：
- 大整数（如
9223372036854775807）转int变成负数或0 - 小数（如
3.14）转int直接截断为3，无警告 - 正确做法是用
get<long long>()</long>或get<int64_t>()</int64_t>接大整数，或用is_number_integer()预检
例如：
if (j["id"].is_number_integer()) {
int64_t id = j["id"].get<int64_t>();
}
</int64_t>
解析深层嵌套或含混合类型的数据时，最容易忽略的是类型断言——比如把字符串当数字用get<int>()</int>，或者把null当对象解引用。宁可多写一行is_xxx()检查，也别依赖文档里“这个字段总是存在”的承诺。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
