Protobuf C++对象转JSON需启用json_format模块并正确链接libprotoc，包含google/protobuf/json/json.h头文件；默认紧凑格式输出下划线命名字段，嵌套消息、repeated字段和枚举按规范转换，timestamp等内置类型自动转RFC3339字符串；须检查消息初始化及oneof分支设置，捕获Status异常而非依赖返回值。
protobuf对象转JSON需要启用json_format模块
默认编译的Protobuf C++库不带JSON序列化能力，必须显式链接 libprotobuf 和 libprotobuf-lite 之外的 libprotoc（或确保启用了 protobuf_json 构建选项），且代码里要包含 google/protobuf/json/json.h。否则调用 MessageToJsonString 会链接失败或报 undefined reference。
- 使用 CMake 时需确认
find_package(protobuf REQUIRED)后，链接了${Protobuf_LIBRARIES}—— 某些发行版（如 Ubuntu 的 libprotobuf-dev）默认不含 JSON 支持，得自己从源码编译 Protobuf 并开启-Dprotobuf_BUILD_PROTOC_BINARIES=ON - 头文件路径必须正确：不是
google/protobuf/util/json_util.h（旧版已弃用），而是google/protobuf/json/json.h - 如果用的是 Bazel 或 vcpkg，检查是否启用了
protobuf_jsonfeature；vcpkg 中需安装protobuf[json]
MessageToJsonString 默认输出紧凑格式，字段名按proto定义而非驼峰
Protobuf 的 JSON 序列化遵循官方规范：字段名用小写下划线（user_name），不是生成的 C++ 成员变量名（user_name_）也不是 CamelCase（userName）。默认不换行、无空格，比如 {"user_id":123,"is_active":true}。
- 若需可读性更好的缩进格式，传入
google::protobuf::json::JsonPrintOptions实例，并设置options.add_whitespace = true - 若想把
user_id输出为userId，需手动配置options.always_print_primitive_fields = true并配合自定义 name mapping —— 但 C++ 原生不支持自动驼峰转换，得自己预处理字段名或改用第三方库（如 nlohmann/json + 手动映射） -
options.preserve_proto_field_names = false不生效 —— 这个选项只影响“是否保留原始 proto 字段名”，而默认就是 true；设为 false 反而会触发未定义行为
嵌套消息、repeated 字段和枚举值都按标准规则处理
Protobuf JSON 格式对复合类型有明确定义：嵌套消息转为对象，repeated 转为数组，枚举转为字符串名（如 "STATUS_OK"）或数值（取决于 options.enforce_proto3_optional_features 和 enum_as_ints 设置）。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 空
repeated字段默认不输出（除非设options.always_print_primitive_fields = true，但对 repeated 无效；真要强制输出空数组，得先手动填充一个 dummy 元素再删掉 —— 不推荐，应由上游协议约定是否省略） - optional 字段在 proto3 中默认不输出 null，即使值为默认（如 int32 为 0）；只有显式调用
set_xxx()后才序列化 —— 这和 proto2 不同，注意前后端协议一致性 - timestamp/duration 等 Well-Known Types 会被转成 RFC 3339 字符串（如
"2024-05-20T10:30:00Z"），无需额外处理
常见错误：空指针、未初始化字段、oneof 未设置分支
调用 MessageToJsonString 时传入未 new 或未 initialize 的 message 指针，会 crash；更隐蔽的是 oneof 字段未 set 任何分支，导致序列化时抛出 google::protobuf::util::Status 异常（而非返回空字符串）。
立即学习“C++免费学习笔记（深入）”；
- 务必检查
message.IsInitialized()返回 true，尤其含 required 字段（proto2）或 oneof（proto3 中虽无 required，但 oneof 必须选其一） - 捕获异常：用
google::protobuf::util::Status status = google::protobuf::json::MessageToJsonString(..., &json)，不要依赖返回值是否为空 - 避免直接传 raw pointer：优先用
const MyProto&或std::shared_ptr<const myproto></const>，防止临时对象析构后引用失效
实际序列化代码就三行核心：
#include <google/protobuf/json/json.h>
std::string json;
google::protobuf::util::Status status = google::protobuf::json::MessageToJsonString(my_msg, &json);
if (!status.ok()) { /* 处理 error */ }
真正卡住人的从来不是这行调用，而是前面的构建配置、字段语义理解、以及 oneof 是否 set 的静默失败。 
