Protocol Buffers

项目简介

Protocol Buffers（简称 protobuf）是 Google 开源的语言中立、平台中立、可扩展的结构化数据序列化机制。开发者用 .proto 文件定义消息结构，再由 protoc 编译器生成目标语言的代码，实现高效的数据读写。

它常被拿来与 JSON、XML 对比：体积更小、解析更快，并且有严格的 schema 约束，因此成为 gRPC、Kubernetes、TensorFlow 等项目的底层数据格式。

核心组成

• protoc 编译器：用 C++ 编写，负责把 .proto 编译成各语言代码
• 各语言运行时：提供序列化、反序列化与消息操作 API
• 标准 .proto 文件：随发行包一起分发的基础类型定义

官方支持的语言包括 C++、Java、Python、Objective-C、C#、Ruby、PHP，Go、Dart、JavaScript 则有独立仓库维护。

快速上手

非 C++ 用户最简单的做法是从 GitHub Releases 下载预编译的 protoc-$VERSION-$PLATFORM.zip，其中包含 protoc 可执行文件和标准 proto 文件。

# 示意：使用 protoc 生成代码（具体参数以官方文档为准）
protoc --cpp_out=./out demo.proto

随后在项目中引入对应语言的运行时库，即可读写消息。

构建与依赖

• 若使用 C++ 或需要修改 protobuf 源码，需从源码构建，参见 src/README.md
• 使用 Bazel 时可通过 Bzlmod 声明依赖：

bazel_dep(name = "protobuf", version = "<VERSION>")

• 传统 WORKSPACE 方式需引入 protobuf_deps() 等加载语句

注意：主分支 HEAD 可能因不兼容变更而临时不可用，生产项目应固定到发布分支的具体提交。

适用与注意事项

protobuf 适合对性能、带宽和跨语言一致性有要求的场景，例如微服务 RPC、移动端网络协议、数据管道。但它并非万能：二进制格式不利于人工排查，需要配套的调试工具；引入代码生成步骤也会增加构建流程的复杂度。

学习资源

• 官方文档站：https://protobuf.dev
• 仓库内 examples/ 目录提供多语言示例
• 开发者社区可通过 Google Group 参与讨论