RapidJSON 不能原地修改文件，因其仅为内存解析库，不支持文件I/O或就地覆写；大文件需流式处理，路径匹配后按值长度决定覆盖或重写全文件。
为什么不能直接用 RapidJSON 原地修改文件
RapidJSON 是内存解析库，不提供文件 I/O 或原地覆写能力。所谓“原地修改”，实际是指：读入、修改、序列化回磁盘——但若 JSON 文件超大（比如 500MB+），全量加载会爆内存，且写回时仍需重写整个文件。真正要解决的，是“如何避免加载全部内容却能精准改某个数值”。
用 ParseStream + 自定义 Handler 实现流式定位与局部改写
核心思路是跳过无关结构，只在目标路径匹配时捕获并替换值，其余内容原样透传到输出流。这需要绕过 Document 解析，改用 SAX 模式（Reader）配合自定义 BaseReaderHandler。
- 必须用
Reader而非Document，否则无法控制解析粒度 - 目标路径需用点号表示（如
"data.items[2].price"），需手动实现路径匹配逻辑（数组索引、对象键名逐级比对） - 改写时机在
Double/Int/Uint回调中触发，此时拿到原始 token 位置和值，可决定是否替换 - 输出不能依赖
Writer直接生成字符串——因为中间有未解析部分，必须把输入流中未处理的原始字节（如空格、换行、注释）也复制过去，所以需用双流（ifstream+ofstream）+ 缓冲区偏移控制
简例：想把 config.json 中 "timeout" 字段从 30 改为 60，且保留原有缩进：
// 关键不是改值，而是记录原始 JSON 中 "timeout": 30 的起始/结束偏移 // 然后 seek 到该位置，用 sprintf 写入 "60" 并补足空格（避免破坏后续结构） // 这要求字段值长度不变或更短；若变长（如 30 → 1200），必须重写后续全部内容
数值长度变化时必须重写文件尾部
JSON 是文本格式，字段值长度改变（如 42 → 999999）会挤占后续字符位置，导致语法错误。RapidJSON 不提供“就地伸缩”能力，因此：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“C++免费学习笔记（深入）”；
- 若新值字符数 ≤ 原值（如
100→50），可用fstream::seekp()定位后覆盖，末尾补空格对齐 - 若新值更长，唯一安全做法是：用
Reader流式解析并写入临时文件，遇到目标字段时插入新值，其余照抄；完成后原子替换原文件 - 不要试图用
mmap手动挪动内存——JSON 结构嵌套深，括号匹配难追踪，极易出错
注意：Writer 默认不保留原始空白，若需维持格式，得自己缓存并重放原始 token 字节，或改用 InsituStringBuffer 配合 ParseInsitu（仅适用于字符串值，且要求内存充足）。
真正适合“大型 JSON”的替代方案
当文件 >100MB 且频繁修改时，RapidJSON 已不是最优选。更务实的做法是：
- 把 JSON 拆成小块，用
std::filesystem::copy_file(..., copy_options::skip_existing)替换单个子文件 - 改用
json-c的json_object_object_get_ex()+json_object_set_int()，它支持部分解析（但仍是全加载） - 根本性规避：改用二进制格式（如 Protocol Buffers 或 FlatBuffers），天然支持字段级更新和 mmap 随机访问
硬要用 RapidJSON 处理 GB 级 JSON，最终往往卡在内存和磁盘 I/O 上，而不是 API 调用是否正确。
