📌 项目地址：protocolbuffers/protobuf | ⭐ 71,522 颗星 | 🔧 C++ | 📜 未标注
为什么选 protobuf，而不是 JSON/XML
在分布式系统、微服务通信或持久化存储中，数据序列化是绕不开的环节。JSON 和 XML 虽然可读性好，但体积大、解析慢、缺少强类型约束。Protocol Buffers（protobuf）正是为解决这些问题而生：它通过预定义的 .proto 文件描述数据结构，生成对应语言的代码，序列化后的二进制体积比 JSON 小 3~10 倍，解析速度也快得多。同时，protobuf 通过字段编号和可选字段机制保证了向前向后兼容，非常适合长期演进的项目。
安装与集成：两种主流方式
protobuf 分为 编译器（protoc） 和 各语言运行时 两部分。README 推荐了两条路径：
1. 下载预编译二进制（非 C++ 用户首选）
访问 GitHub Releases，在对应版本的下载区找到 protoc-*-*.zip，解压后即可使用 protoc 命令。这是最省心的方式，无需从源码编译。
2. 用 Bazel 管理依赖（C++ 或构建系统用户）
protobuf 官方仓库对 Bazel 支持完善。如果你的项目使用 Bazel 8+，可以在 MODULE.bazel 中添加：
bazel_dep(name = "protobuf", version = "<version>")
如果是遗留的 WORKSPACE 系统，则需按 README 中的方式引入 http_archive 并加载依赖：
http_archive(
name = "com_google_protobuf",
strip_prefix = "protobuf-VERSION",
sha256 = "...",
url = "...",
)
load("@com_google_protobuf//:protobuf_deps.bzl", "protobuf_deps")
protobuf_deps()
# 随后还需加载 rules_java 和 rules_python 的 toolchain
注意：README 强调，如果从 main 分支源码构建，可能会遇到 API 不兼容或测试不充分的问题。建议基于 release tag 或 release branch 进行构建，以保证稳定性。
核心工作流：定义 .proto → 生成代码 → 序列化/反序列化
虽然 README 没有给出具体的 .proto 文件示例，但 protobuf 的典型用法是：
- 编写
message.proto，定义数据结构，例如：
protobuf
syntax = "proto3";
message Person {
string name = 1;
int32 age = 2;
repeated string tags = 3;
} - 使用
protoc命令生成目标语言的代码（具体命令参见官方文档）。 - 在代码中直接调用生成的类进行序列化（SerializeToString）或反序列化（ParseFromString）。
这一套流程保证了数据格式的统一性，且代码无需手动解析字节流，安全性更高。
和同类工具的区别
| 特性 | protobuf | JSON / XML |
|---|---|---|
| 序列化大小 | 小（二进制） | 大（文本，含冗余字符） |
| 解析性能 | 快（直接操作二进制） | 慢（需解析字符串） |
| 类型安全 | 强类型，编译期检查 | 弱类型，运行时可能出错 |
| 可读性 | 差（二进制） | 好（纯文本） |
| 向后兼容 | 依赖字段编号与可选字段，精细控制 | 依赖字段名，扩展性较弱 |
适合使用 protobuf 的场景：跨语言 RPC 通信（如 gRPC 默认使用 protobuf）、大数据管道（Avro 也是竞品，但 protobuf 生态更丰富）、需要长期维护的配置文件（相比 JSON Schema，protobuf 更紧凑且生成代码更可靠）。
注意事项
- 版本匹配：protoc 编译器的版本和运行时库的版本必须完全一致，否则可能出现序列化/反序列化失败。建议从同一 release 下载。
- 向后兼容设计：新增字段必须分配新的编号，且不能修改现有字段的类型或编号。删除字段时建议使用
reserved语法，防止未来编号冲突。 - License：BSD 3-Clause，商业友好。
- 学习曲线：需要写
.proto文件，并理解字段编号、枚举、map 等概念，相比 JSON 直接上手有一定门槛。
结语
Protocol Buffers 已经是数据序列化领域的事实标准之一，无论是构建 gRPC 服务，还是处理大规模日志、推荐系统特征数据，它都能在效率和维护性之间取得平衡。如果你正在寻找一种比 JSON 更可靠、更紧凑的序列化方式，protobuf 值得投入时间学习。