最稳方式是将下载的json.hpp放入项目目录（如./include/nlohmann/json.hpp），用#include "nlohmann/json.hpp"并配target_include_directories(your_target private ./include)；路径错误是“找不到文件”的唯一原因，与语法无关。
编译器找不到 nlohmann/json.hpp 是最常见卡点，不是代码写错，而是头文件路径没配对。
怎么让 C++ 项目找到 nlohmann/json.hpp
这个库是 header-only，不编译、不链接、不装系统级包——只要编译器能“看见”那个 json.hpp 文件就行。
- 最稳方式：把
json.hpp（从 GitHub release 页面 下载 single_include 版本）放进项目目录，比如./include/nlohmann/json.hpp，然后写#include "nlohmann/json.hpp" - 用 CMake 的话，加这句：
target_include_directories(your_target PRIVATE ./include)，别用过时的include_directories() - 用 vcpkg 安装后，头文件通常在
/vcpkg/installed/x64-linux/include/nlohmann/json.hpp（路径随 triplet 变），CMake 中要find_package(nlohmann_json CONFIG REQUIRED)并target_link_libraries(your_target PRIVATE nlohmann_json::nlohmann_json) - 错误信息
fatal error: nlohmann/json.hpp: No such file or directory就是路径问题，和语法无关
读 JSON 文件时为什么 file >> j 会崩
因为 std::ifstream 默认以文本模式打开，遇到 UTF-8 BOM（\xEF\xBB\xBF）直接报 [json.exception.parse_error.101]；空文件、全空白、前端传来的乱码字符串也会触发解析失败。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 推荐二进制读取 + 手动跳过 BOM：
std::ifstream f("config.json", std::ios::binary)，读完检查前 3 字节是否为 BOM，是就buf.substr(3) - 或者坚持用
json::parse()+try/catch，别依赖流操作符：auto j = json::parse(buf, nullptr, false)，再用j.is_discarded()判断是否解析失败 -
file >> j看似简洁，但出错时异常类型是std::exception，无法区分是 IO 错还是 JSON 错，不建议用于生产环境
j["key"] 和 j.at("key") 到底该用哪个
前者静默返回 null 值，后者严格检查存在性并抛 std::out_of_range——选哪个取决于你是否想让错误早点暴露。
- 访问嵌套字段如
j["data"]["items"][0]["id"]，任意一级缺失都会让整条链变成 null，后续调用.get<int>()</int>就崩在type_error，很难定位哪一级出问题 - 调试阶段优先用
j.at("data").at("items").at(0).at("id").get<int>()</int>，一错就停在具体位置 - 上线后若需容错，先
if (j.contains("data") && j["data"].is_object()) { ... }，再安全访问 - 注意：
j["missing"]不等于j.is_null()，它返回的是一个空的 json 对象，j["missing"].is_null() == true才成立
结构体转 JSON 为什么编译不过
漏写 to_json 或 from_json 函数，或没放在 nlohmann 命名空间里，编译器根本不会识别你的类型。
- 必须定义在
namespace nlohmann {内，且函数签名严格匹配：void to_json(json& j, const MyStruct& s)和void from_json(const json& j, MyStruct& s) - 如果结构体含非默认构造成员（比如
std::string_view或第三方类如uri），不能靠普通to_json，得特化adl_serializer<t></t> - 没写
from_json却调用j.get<mystruct>()</mystruct>，错误提示是no matching function for call to ‘from_json’，非常隐晦
真正难的从来不是“怎么写”，而是“怎么让错误信息指向真实问题”——BOM、路径、命名空间、异常捕获层级，这些地方错一点，调试时间翻倍。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
