Protobuf3 默认不支持直接序列化为JSON，需通过google/protobuf/util/json_util.h中的MessageToJsonString()实现，并显式链接libprotobuf-util；默认省略默认值字段，可通过JsonPrintOptions控制输出行为。
Protobuf 3 默认不支持直接序列化为 JSON
Google 官方的 protobuf C++ 库（v3.0+）本身不提供开箱即用的 SerializeToJsonString() 方法。你看到的很多教程里调用的 JsonPrintOptions 或 MessageToJsonString()，其实来自 google/protobuf/util/json_util.h —— 这个头文件不是基础库的一部分，而是 protobuf::util 工具模块，需要显式链接 libprotobuf-util（或对应静态/动态库），否则链接会失败。
常见错误现象：undefined reference to 'google::protobuf::util::MessageToJsonString'，本质就是漏了链接或没包含正确头文件。
- 必须
#include <google/protobuf/util/json_util.h> - 编译时需链接
-lprotobuf -lprotobuf-util（CMake 中对应target_link_libraries(... protobuf protobuf_util)） - 确保 Protobuf 版本 ≥ 3.0.0；低于此版本无该工具模块
使用 MessageToJsonString() 的基本流程
这是最常用、最轻量的方式，适合调试和简单导出。它默认使用“规范 JSON”格式（字段名小驼峰转下划线，省略默认值，不保留未知字段）。
#include <google/protobuf/util/json_util.h>
#include "your_message.pb.h"
YourMessage msg;
msg.set_id(123);
msg.set_name("test");
std::string json;
google::protobuf::util::MessageToJsonString(msg, &json);
// json == {"id":123,"name":"test"}
- 输出字符串不含换行缩进，如需美化，用
JsonPrintOptions::add_whitespace = true - 若字段含 bytes 类型，默认 Base64 编码；设
options.always_print_primitive_fields = true可强制输出空字段 - 遇到嵌套 message 或 repeated 字段，自动递归处理，无需手动展开
控制 JSON 输出行为：JsonPrintOptions 关键参数
默认行为对调试友好，但生产环境常需定制。比如前端要求 PascalCase 字段名、保留 0 值字段、或兼容旧版 API。
立即学习“C++免费学习笔记（深入）”；
google::protobuf::util::JsonPrintOptions options; options.preserve_proto_field_names = true; // 用 proto 定义名（如 user_name），而非 JSON 风格名（user_name → user_name） options.always_print_primitive_fields = true; // 输出 int32 id = 0; 对应 "id": 0 options.add_whitespace = true; // 换行 + 2 空格缩进 options.format_int64_as_number = true; // int64 输出为数字而非字符串（默认是字符串，防 JS number 精度丢失） std::string json; google::protobuf::util::MessageToJsonString(msg, &json, options);
-
preserve_proto_field_names = true是对接老系统最常开的选项，避免字段名被自动转换 -
format_int64_as_number = true要谨慎：JS 安全整数上限是 2^53−1，超限后精度丢失，某些场景反而要保持字符串形式 - 不设置
options时，所有字段均为默认值，等价于传入一个空构造的JsonPrintOptions
遇到 unknown field 或 Any 类型怎么办
Protobuf 的 Any 和未知字段（比如新字段被旧客户端收到）在默认 JSON 打印中会被忽略。如果业务依赖这些数据（例如配置下发、灰度字段），必须显式启用解析支持。
- 对
Any：需先调用Any::UnpackTo(&target_msg)再序列化，或使用JsonParseOptions::ignore_unknown_fields = false配合反向操作 - 对未知字段：设
options.ignore_unknown_fields = false并配合JsonParseOptions在解析端启用，但打印端仍不输出；真正要导出未知字段，得用反射遍历GetReflection()->GetUnknownFields()手动拼接 —— 这属于高级用法，非常少见 - 更实际的做法：升级 .proto 文件并重新生成代码，让字段“已知”；或者约定 Any 字段内部封装为标准 JSON string，由业务层二次 decode
真正难的不是怎么转 JSON，而是想清楚哪些字段该出现、用什么命名规则、int64 怎么传、以及 unknown field 是否真的需要暴露 —— 这些决策比写几行代码花的时间多得多。
