应使用nlohmann/json等成熟库而非手动拼接：它支持std::vector等STL容器自动转JSON，自定义struct需显式定义to_json/from_json函数，注意键顺序、性能优化及字段校验。
std::vector 转 JSON 时别直接用 std::to_string
直接循环拼接 std::to_string 得到的字符串不是合法 JSON：缺方括号、逗号分隔不规范、没有引号包裹（对字符串类型而言）。JSON 是结构化文本格式，不是简单拼接。
正确做法是使用成熟序列化库处理容器边界和类型差异。推荐优先考虑 nlohmann/json（头文件仅需 #include <nlohmann/json.hpp>），它对 STL 容器有原生支持：
#include <nlohmann/json.hpp>
#include <vector>
using json = nlohmann::json;
std::vector<int> v = {1, 2, 3};
json j = v; // 自动转为 [1,2,3]
std::string s = j.dump(); // → "[1,2,3]"
-
nlohmann::json构造函数重载了对std::vector、std::map、std::unordered_map等的隐式转换 - 嵌套容器也自动递归处理：
std::vector<std::map<std::string, int>>→ JSON 数组含多个对象 - 若用
dump(2)可加缩进，便于调试；生产环境建议用dump()（无空格）减小体积
自定义 struct 序列化必须显式定义 to_json/from_json
STL 容器能自动转 JSON，但你的自定义结构体不行——编译器不知道字段名和顺序。不写序列化函数会报错：no matching function for call to 'to_json'。
必须在命名空间内提供两个自由函数（不能是成员函数）：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
立即学习“C++免费学习笔记（深入）”；
#include <nlohmann/json.hpp>
struct Person {
std::string name;
int age;
};
// 必须在 Person 所在命名空间（或全局）中定义
void to_json(json& j, const Person& p) {
j = json{{"name", p.name}, {"age", p.age}};
}
void from_json(const json& j, Person& p) {
j.at("name").get_to(p.name);
j.at("age").get_to(p.age);
}
- 字段名必须与 JSON 键名严格一致，大小写敏感
- 用
j.at("key")而非j["key"]：前者抛异常（可捕获），后者静默返回 null 值，容易掩盖字段缺失问题 - 如果结构体含
std::vector<Person>，无需额外操作——只要Person支持序列化，外层容器就能自动处理
std::map<std::string, T> 和 std::unordered_map<std::string, T> 行为不同
std::map 序列化后键名默认按字典序排列；std::unordered_map 则保持插入顺序（nlohmann/json v3.11+ 默认行为），但该顺序不保证跨平台或跨版本一致。
- 若 JSON 消费方依赖键顺序（如前端展示顺序），应改用
std::map或手动转为std::vector<std::pair<std::string, T>>控制顺序 -
std::unordered_map的哈希随机化可能影响测试稳定性，CI 中偶发失败常源于此 - 所有键类型必须是
std::string（或能隐式转为std::string）；用int当 key 会编译失败
性能敏感场景慎用 operator= 直接赋值
对大容器（如百万级 std::vector<double>），写 json j = my_vec; 会触发完整拷贝。实际只需视图式序列化时，可用 json::array() 配合 reserve + emplace_back 避免中间分配：
json j = json::array();
j.reserve(my_vec.size()); // 预分配内存
for (const auto& x : my_vec) {
j.emplace_back(x); // 移动而非拷贝
}
-
reserve()减少内部 vector 重分配次数，对大数组提升明显 - 若容器元素是复杂对象，确保其
to_json函数高效（例如避免深拷贝内部缓存） - 调试时用
j.is_array()/j.is_object()校验类型，比字符串匹配更可靠
from_json 中用 at() 还是 []——线上服务里一个未检查的缺失字段，可能让整个请求解析静默失败为默认值。 
