rapidjson::Document解析失败却无报错，主因是BOM未处理、流状态异常或缓冲区不可写；需用binary模式读取、手动跳过UTF-8 BOM、检查ifstream状态、选用ParseStream或ParseInsitu并确保buffer可写且生命周期足够。
rapidjson::Document 解析失败但没报错？检查流读取是否截断
用 std::ifstream 读 JSON 文件进 std::string 再 parse，最容易漏掉 BOM 和换行符处理。RapidJSON 默认不跳过 UTF-8 BOM，如果文件以 \xEF\xBB\xBF 开头，Parse() 会静默失败（HasParseError() 返回 true，但很多人没查）。
- 读文件时用
std::ios::binary模式打开，避免 Windows 下\r\n被误转成单个\n - 读完后手动跳过 UTF-8 BOM：
if (str.size() >= 3 && str[0] == '\xEF' && str[1] == '\xBB' && str[2] == '\xBF') str.erase(0, 3); - 别直接传
std::string.c_str()给Parse()—— RapidJSON 需要可修改缓冲区，得用ParseInsitu()或先CopyFrom()
rapidjson::IStreamWrapper 怎么正确绑定 std::ifstream
IStreamWrapper 是最简流式解析方式，但它对流状态很敏感。一旦 ifstream 在构造 wrapper 前已处于 failbit 或 eofbit，后续 Parse() 必然失败且无提示。
- 构造前必须检查：
if (!ifs.is_open() || !ifs.good()) { /* 处理错误 */ } - 不要复用同一个
std::ifstream对象多次解析 —— 它内部位置指针不会自动重置，需调用ifs.clear(); ifs.seekg(0); - 推荐写法：
std::ifstream ifs("config.json", std::ios::binary); rapidjson::IStreamWrapper isw(ifs); rapidjson::Document doc; doc.ParseStream(isw);
ParseStream 和 ParseInsitu 的性能与内存差异
二者都绕过字符串拷贝，但机制完全不同：ParseStream 边读边解析，内存占用低但不可回溯；ParseInsitu 把整个 buffer 当作可修改内存原地解析（比如把双引号替换成
二者都绕过字符串拷贝，但机制完全不同：ParseStream 边读边解析，内存占用低但不可回溯；ParseInsitu 把整个 buffer 当作可修改内存原地解析（比如把双引号替换成 \0），快但要求 buffer 可写。
- 用
ParseStream时，输入流必须支持随机访问（std::ifstream可以，std::cin不行） - 用
ParseInsitu必须确保 buffer 生命周期长于Document，且不能是 string literal 或栈上小数组 - 大文件（>1MB）优先选
ParseStream；小配置文件且追求极致速度可用ParseInsitu，但记得用std::vector<char></char>分配 buffer
中文字段解析乱码或 key 匹配失败？确认编码和比较方式
RapidJSON 默认按字节比较 key，UTF-8 编码的中文 key 没问题，但如果你用 const char* 字面量去 FindMember()，而源 JSON 里是 GBK 编码，那就完全对不上。
立即学习“C++免费学习笔记（深入）”；
- 确保 JSON 文件保存为 UTF-8 无 BOM（编辑器里显式指定，别信“自动”）
- 别用
strcmp或裸char*比较 key —— 用Value::GetObject().FindMember("中文key")，它走的是字节精确匹配 - 如果 JSON 来自网络或不可控来源，先用
rapidjson::UTF8::Validate()检查是否合法 UTF-8
实际项目里，最常卡住的地方不是语法，而是流状态没清、BOM 没剥、buffer 生命周期搞错 —— 这些点一漏，HasParseError() 可能返回 false，但 IsObject() 就是 false，debug 时容易绕远。
