nlohmann/json是C++最主流JSON库，头文件即用、无依赖、支持C++11+；下载json.hpp包含即可，解析支持字符串/文件/流，推荐at()或value()安全访问，遍历用范围for。
直接用 nlohmann/json 是目前 C++ 解析 JSON 最省心、最主流的选择——它头文件即用、无依赖、支持 C++11 起，且 API 直观得接近 Python 的 json 模块。
如何快速集成 nlohmann/json 到项目中
不需要编译安装，只要把单个头文件 json.hpp 放进工程即可：
- 从 GitHub releases 下载最新版
json.hpp，或用git submodule add https://github.com/nlohmann/json - 确保编译器启用 C++11 或更高标准（
-std=c++11或以上） - 在源码中包含：
#include <json.hpp> // 注意：不是 <nlohmann/json.hpp>，默认不带命名空间前缀
- 如果项目用了命名空间隔离，可加
using json = nlohmann::json;简化后续写法
解析字符串、文件和流的三种常用方式
核心类型是 nlohmann::json，它自动推导结构，无需提前定义 schema。
- 从字符串解析：
std::string json_str = R"({"name":"Alice","age":30})"; nlohmann::json j = nlohmann::json::parse(json_str); - 从文件读取（需
<fstream>）：std::ifstream ifs("data.json"); nlohmann::json j = nlohmann::json::parse(ifs); - 从 std::istream（如
std::cin或网络响应流）：nlohmann::json j = nlohmann::json::parse(std::cin);
⚠️ 注意：parse() 遇到非法 JSON 会抛出 nlohmann::json::parse_error 异常，生产环境务必捕获。
alfred-github-backup
下载
GitHub 仓库备份技能 - 将 OpenClaw 工作空间自动或手动备份至 GitHub 私有仓库。支持自动定时备份和手动交互式配置，引导完成 Token 配置、仓库创建、首次备份及定时任务设置。用途：(1) 首次设置 (2) 日常备份。
立即学习“C++免费学习笔记（深入）”；
安全访问嵌套字段与类型检查
直接用 j["key"] 可能崩溃（键不存在或类型不匹配），推荐用 at() 或带默认值的 value()。
-
j.at("user").at("profile").at("email")：越界时抛异常，适合确定结构的场景 -
j.value("count", 0)：若"count"不存在或非数字，返回默认值0 -
j["items"].is_array()和j["id"].is_number_integer()：做类型断言再取值，避免隐式转换出错 - 遍历数组：
for (const auto& item : j["items"]) { std::cout << item["name"].get<std::string>() << "\n"; }
常见坑：中文乱码、浮点精度与移动语义
nlohmann/json 默认按 UTF-8 处理字符串，但如果你的源数据是 GBK 或其他编码，必须在解析前转成 UTF-8——库本身不处理编码转换。
- JSON 中
123.45默认解析为double，若需高精度整数（如 ID 超过2^53），应显式用get<int64_t>()</int64_t>或启用JSON_USE_INT64宏 - 大 JSON 对象频繁拷贝开销大，优先用移动语义：
nlohmann::json j = std::move(parsed_json);
- 写入时注意
j.dump(2)的第二个参数是缩进空格数，传0得紧凑格式；默认不转义中文（符合 RFC），无需额外设置
真正容易被忽略的是：当 JSON 来自不可信输入（比如 HTTP 请求体）时，parse() 默认不限制嵌套深度和 key 数量，可能被恶意构造的超深结构触发栈溢出或 OOM——上线前建议用 json::parse(str, nullptr, false) 关闭异常，并配合 max_object_size 等参数做限制，或者用 json::accept() 先校验合法性。
