FileReadStream可避免超大JSON文件解析时内存爆炸，需用"rb"模式打开文件、合理设置缓冲区（如64KB）、手动fclose、检查ParseResult错误码及偏移量、预分配MemoryPoolAllocator并确保其生命周期覆盖Document使用期。
用 FileReadStream 避免内存爆炸
超大 JSON 文件（比如几百 MB 甚至 GB 级）直接用 doc.Parse(json_str) 会把整个文件读进内存再解析，极易 OOM。RapidJSON 提供的 FileReadStream 是专为这事设计的——它不加载全文，而是按块读、边读边解析。
关键点在于缓冲区大小和文件打开模式：
- 必须用
"rb"模式打开文件（二进制），否则 Windows 下换行符可能被误转，导致解析偏移错乱 - 缓冲区不是越大越好：64KB 是默认推荐值；超过 100MB 的文件可设为 256KB，但别盲目堆到 1MB——过大会拖慢缓存局部性，反而降低吞吐
-
FileReadStream内部不 owns 文件指针，fclose(fp)必须由你手动调用，漏关会导致句柄泄漏
FILE* fp = fopen("huge.json", "rb");
if (!fp) { /* handle error */ }
char buffer[65536];
FileReadStream is(fp, buffer, sizeof(buffer));
Document doc;
ParseResult result = doc.ParseStream(is);
fclose(fp); // 别忘这句
解析失败时必须检查 ParseResult，不能只看 doc.IsObject()
很多人写成 if (doc.IsObject()) { ... } 就开始取字段，这是危险的。一旦解析出错，doc 处于未定义状态，后续访问会 crash 或返回垃圾值。
ParseStream() 返回 ParseResult（本质是 bool），它携带两个关键信息：Code() 和 Offset()：
-
result.Code() == kParseErrorNone才算真正成功 -
result.Offset()指向出错字符在原始流中的字节位置，配合GetParseError_En(result.Code())能准确定位是缺引号、多逗号，还是编码非法 - 错误码不是 errno 风格，不要用
strerror()；必须包含"rapidjson/error/en.h"才能用GetParseError_En
避免反复分配：预设 MemoryPoolAllocator 容量
超大 JSON 解析时，Document 默认的 MemoryPoolAllocator 会按需申请多个 64KB Chunk。频繁分配本身有开销，更糟的是——如果 JSON 嵌套极深或数组极大，可能触发 Chunk 链表遍历，影响性能。
更稳的做法是预估节点数，一次性分配足够大的池：
- 每个
Value节点在 64 位平台占 16 字节（不含字符串内容），粗略按 JSON 字符数 ÷ 10 估算节点数（经验系数） - 用
MemoryPoolAllocator构造时传入初始容量，例如MemoryPoolAllocator(1024 * 1024)预分配 1MB 池空间 - 把这个 allocator 传给
Document构造函数，而不是依赖默认构造：Document doc(kParseDefaultFlags, &myAllocator) - 注意：这个 allocator 不能跨 Document 复用；每次解析新文档，应新建 allocator 或重置（
Clear()）
流式解析后别直接改树，小心内存池生命周期
用 ParseStream() 解析完，Document 的所有节点都来自那个 MemoryPoolAllocator。如果你之后调用 doc.AddMember() 或 PushBack()，新增节点仍从同一池分配——这没问题；但若你把 doc 存活时间拉得很长（比如塞进全局缓存），而 allocator 是栈变量或短生命周期对象，就会悬垂引用。
安全做法只有两种：
- 解析 + 使用 + 销毁全在同一个作用域内，allocator 和 doc 同生共死
- 需要长期持有，就用
CrtAllocator（标准 malloc/free）替代，虽然慢一点，但内存归属清晰：Document doc(kParseDefaultFlags, CrtAllocator())
最易被忽略的一点：FileReadStream 的缓冲区（比如你定义的 char buffer[65536]）必须在整个解析过程中保持有效——不能是函数栈上临时数组且函数已返回。否则解析中途读到野指针区域，行为未定义。
