JSON文件不能直接追加，必须重写整个文件；因其结构化特性，末尾多逗号、少括号或未闭合均导致非法，标准JSON不支持流式追加，正确做法是读取→解析→修改→序列化→覆盖写入，并对空或损坏文件做容错初始化。
JSON文件不能直接“追加”，必须重写整个文件
很多人以为像日志文件一样用 std::ofstream 以 ios::app 模式打开就能追加，但 JSON 是结构化文本——末尾多一个逗号、少一个右括号，或对象/数组没闭合，整个文件就非法。标准 JSON 不支持流式追加，jsoncpp、nlohmann/json 等库读取时会直接抛异常或返回空对象。
正确做法是：读入全部内容 → 解析为内存对象 → 修改（如 push_back 到数组、insert 到对象）→ 序列化回字符串 → 覆盖写入原文件。
- 如果原文件为空或损坏，需先做容错处理（比如初始化为
{}或[]） - 不要用
std::ofstream::app直接写 JSON 片段，那只会产生无效 JSON - 小文件（simdjson 的 streaming mode），但依然无法跳过“读-改-写”流程
用 nlohmann/json 追加到 JSON 数组最常用
多数场景是往日志类 JSON 文件（如 [{...}, {...}]）里加新条目。nlohmann/json 使用最直观：
#include <fstream>
#include <nlohmann/json.hpp>
nlohmann::json j;
std::ifstream f("data.json");
if (f.is_open()) {
try {
f >> j; // 自动识别是对象还是数组
} catch (...) {
j = nlohmann::json::array(); // 解析失败就新建空数组
}
} else {
j = nlohmann::json::array();
}
// 确保 j 是数组，再 push
if (!j.is_array()) j = nlohmann::json::array();
j.push_back({{"timestamp", "2024-06-15T10:30:00Z"}, {"value", 42}});
std::ofstream("data.json") << std::setw(2) << j << std::endl;
-
j.push_back(...)只对数组有效；若原文件是对象（{}），需用j["items"]先取字段再 push -
std::setw(2)控制缩进，不加则输出为单行；生产环境建议加std::ofstream::binary和std::ofstream::trunc显式清空 - 注意文件编码：Windows 默认 ANSI，而 JSON 必须 UTF-8；用
std::wifstream+ BOM 处理复杂，推荐统一用 UTF-8 无 BOM 文本
并发写入时必须加锁，否则文件被覆盖或损坏
多个进程/线程同时写同一 JSON 文件，哪怕只有一行代码 ofstream("data.json") << j，也会因竞态导致数据丢失或 JSON 格式破坏。C++ 标准库不提供跨进程文件锁。
立即学习“C++免费学习笔记（深入）”；
- Linux/macOS：用
flock()（配合open()获取 fd）实现 advisory lock - Windows：用
CreateFile()+LOCKFILE_EXCLUSIVE_LOCK - 更简单但有局限的做法：写临时文件（如
data.json.tmp），再rename()原子替换（POSIX）或MoveFileEx()（Windows） - 若只是单线程多函数调用，可用
std::mutex保护写操作，但无法防进程级冲突
jsoncpp 用户注意：Json::Value 默认不支持 UTF-8 字符串自动转义
如果你用的是较老的 jsoncpp（如 1.9.x），Json::Value 的 operator[] 对中文键名或值可能出乱码，因为内部用 std::string 存储但未强制 UTF-8 编码检查。
- 写入前手动确保字符串是 UTF-8 编码（例如 Windows 上用
WideCharToMultiByte(CP_UTF8, ...)） - 避免直接传
std::wstring给Json::Value；它不会自动转换 -
Json::StreamWriterBuilder需设置settings["indentation"] = " "才能格式化，否则输出无缩进 - 新版 jsoncpp（1.9.5+）已支持
Json::CharReaderBuilder的 UTF-8 检查，但默认关闭，需显式启用
真正麻烦的不是语法，而是每次写都得把整个 JSON 加载进内存再吐出去——文件越大，延迟越明显，出错机会也越多。别省那几行代码去“优化”追加逻辑，JSON 就是这么设计的。
