需确保编译器能找到nlohmann/json.hpp：推荐将nlohmann文件夹复制到项目include目录并用#include "nlohmann/json.hpp"，CMake中配置target_include_directories；解析时必须try/catch parse_error或用parse(..., false)并检查is_discarded()。

如何确认 nlohmann/json 已正确安装并被 C++ 项目识别

很多问题其实卡在编译器根本没找到 nlohmann/json.hpp，而不是语法写错。nlohmann/json 是 header-only 库，不需要编译安装，但必须确保头文件路径对编译器可见。

• 推荐方式：把 nlohmann 文件夹（含 json.hpp）直接复制到项目源码目录下，比如 ./include/nlohmann/json.hpp，然后用 #include "nlohmann/json.hpp"
• 若用 CMake，添加 include_directories(./include) 或更现代的 target_include_directories(your_target PRIVATE ./include)
• 用 pkg-config 或系统包管理器（如 apt install nlohmann-json3-dev）安装后，头文件通常在 /usr/include/nlohmann/json.hpp，需确认 g++ -I/usr/include 是否生效
• 常见错误信息：fatal error: nlohmann/json.hpp: No such file or directory —— 这说明路径配置失败，不是库本身问题

解析 JSON 字符串时，json::parse() 的异常处理为什么不能省略

json::parse() 在输入非法 JSON 时默认抛出 nlohmann::json::parse_error 异常，不捕获会导致程序崩溃。生产环境几乎从不直接裸调用它。

• 必须用 try/catch 包裹，且建议捕获具体类型：catch (const nlohmann::json::parse_error& e)
• 可改用带默认值的解析： json j = json::parse(input, nullptr, false); —— 第三个参数 false 表示“失败时不抛异常”，此时需手动检查 j.is_discarded()
• 注意：空字符串、纯空白、null 字面量都会触发解析失败，别假设前端传来的一定是合法 JSON
• 示例：

  std::string s = R"({"name": "Alice", "age":)}"; // 缺少数字
  try {
      auto j = nlohmann::json::parse(s);
  } catch (const nlohmann::json::parse_error& e) {
      std::cerr << "JSON parse error at byte " << e.byte << ": " << e.what() << "\n";
  }

访问嵌套对象或数组时，operator[] 和 at() 的行为差异很关键

两者都支持键名或索引访问，但容错逻辑完全不同：一个静默返回 null，一个严格检查并抛异常。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• j["user"]["profile"]["avatar"]：任意一级不存在（比如 "user" 键缺失），整条链返回 json::value_t::null，后续调用 .get<:string>()</:string> 会抛 type_error
• j.at("user").at("profile").at("avatar")：任一 key 不存在立即抛 out_of_range，便于快速定位哪一层缺失
• 安全做法是先用 j.contains("key") 检查存在性，再访问；或统一用 at() + try/catch
• 数组越界同理：j[100] 返回 null，j.at(100) 抛异常 —— 对日志或配置类数据，后者更能暴露结构误判

序列化输出时，dump() 的缩进与浮点精度怎么控制

dump() 默认不缩进、不保留小数位，但实际调试和 API 返回常需要可读格式或精确数值。

立即学习“C++免费学习笔记（深入）”；

• 带缩进： j.dump(2) —— 参数为缩进空格数，dump(0) 是紧凑模式（默认）
• 控制浮点数：用 json::dump(..., int indent, bool ensure_ascii, bool allow_exceptions, bool skip_final_newline, bool precision) 不行 —— 实际要用 json::serializer 或预设精度：
• 更简单方式：先设置全局浮点格式，json::default_float_precision = 15;，或对单个值用 std::setprecision 配合 std::stringstream 手动转
• 中文乱码？确保输入字符串是 UTF-8 编码，且 dump() 输出未被终端/IDE 误判编码；ensure_ascii=false（默认）即允许非 ASCII 字符直接输出

C++ 解析 JSON 真正的难点不在语法，而在错误路径覆盖和数据契约校验 —— 比如你认为必有的字段实际为空，或前端把数字传成字符串，这些都得靠组合 contains()、is_string()、is_number() 显式判断，不能依赖 operator[] 的静默行为。