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>
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")
<ul>
<li>
<code>j.push_back(...)</code> 只对数组有效；若原文件是对象（<code>{}</code>），需用 <code>j["items"]</code> 先取字段再 push</li>
<li>
<code>std::setw(2)</code> 控制缩进，不加则输出为单行；生产环境建议加 <code>std::ofstream::binary</code> 和 <code>std::ofstream::trunc</code> 显式清空</li>
<li>注意文件编码：Windows 默认 ANSI，而 JSON 必须 UTF-8；用 <code>std::wifstream</code> + BOM 处理复杂，推荐统一用 UTF-8 无 BOM 文本</li>
</ul>
<h3>并发写入时必须加锁，否则文件被覆盖或损坏</h3>
<p>多个进程/线程同时写同一 JSON 文件，哪怕只有一行代码 <code>ofstream("data.json") ，也会因竞态导致数据丢失或 JSON 格式破坏。C++ 标准库不提供跨进程文件锁。</code></p>
<ul>
<li>Linux/macOS：用 <code>flock()</code>（配合 <code>open()</code> 获取 fd）实现 advisory lock</li>
<li>Windows：用 <code>CreateFile()</code> + <code>LOCKFILE_EXCLUSIVE_LOCK</code>
</li>
<li>更简单但有局限的做法：写临时文件（如 <code>data.json.tmp</code>），再 <code>rename()</code> 原子替换（POSIX）或 <code>MoveFileEx()</code>（Windows）</li>
<li>若只是单线程多函数调用，可用 <code>std::mutex</code> 保护写操作，但无法防进程级冲突</li>
</ul>
<h3>jsoncpp 用户注意：<code>Json::Value</code> 默认不支持 UTF-8 字符串自动转义</h3>
<p>如果你用的是较老的 <code>jsoncpp</code>（如 1.9.x），<code>Json::Value</code> 的 <code>operator[]</code> 对中文键名或值可能出乱码，因为内部用 <code>std::string</code> 存储但未强制 UTF-8 编码检查。</p>
<ul>
<li>写入前手动确保字符串是 UTF-8 编码（例如 Windows 上用 <code>WideCharToMultiByte(CP_UTF8, ...)</code>）</li>
<li>避免直接传 <code>std::wstring</code> 给 <code>Json::Value</code>；它不会自动转换</li>
<li>
<code>Json::StreamWriterBuilder</code> 需设置 <code>settings["indentation"] = " "</code> 才能格式化，否则输出无缩进</li>
<li>新版 jsoncpp（1.9.5+）已支持 <code>Json::CharReaderBuilder</code> 的 UTF-8 检查，但默认关闭，需显式启用</li>
</ul>
<p>真正麻烦的不是语法，而是每次写都得把整个 JSON 加载进内存再吐出去——文件越大，延迟越明显，出错机会也越多。别省那几行代码去“优化”追加逻辑，JSON 就是这么设计的。</p></nlohmann></fstream>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
