原始缓冲区
Protocol
版权所有 2023 Google LLC
Protocol Buffers（又名 protobuf）是 Google 的语言中立、平台中立、可扩展的机制，用于序列化结构化数据。您可以在 protobuf 的文档中了解更多信息。
此 README 文件包含 protobuf 安装说明。要安装 protobuf，您需要安装协议编译器（用于编译 .proto 文件）和您选择的编程语言的 protobuf 运行时。
大多数用户会发现使用受支持的版本是最简单的途径。
如果您选择从主分支的头部修订版开始工作，您的构建有时会因源代码不兼容的更改和未充分测试（因此损坏）的行为而被破坏。
如果您使用 C++ 或需要从源代码构建 protobuf 作为项目的一部分，则应固定到发布分支上的发布提交。
这是因为即使发布分支在发布提交之间也可能会遇到一些不稳定的情况。
protobuf 编译器是用 C++ 编写的。如果您使用 C++，请按照 C++ 安装说明安装 protoc 以及 C++ 运行时。
对于非 C++ 用户，安装协议编译器的最简单方法是从我们的 GitHub 发布页面下载预构建的二进制文件。
在每个版本的下载部分，您可以在 zip 包中找到预构建的二进制文件： protoc-$VERSION-$PLATFORM.zip 。它包含 protoc 二进制文件以及与 protobuf 一起分发的一组标准.proto文件。
如果您正在寻找发布页面中未提供的旧版本，请查看 Maven 存储库。
这些预构建的二进制文件仅针对已发布的版本提供。如果你想使用 HEAD 的 github 主版本，或者你需要修改 protobuf 代码，或者你正在使用 C++，建议从源代码构建你自己的 protoc 二进制文件。
如果您想从源代码构建 protoc 二进制文件，请参阅 C++ 安装说明。
Protobuf 支持多种不同的编程语言。对于每种编程语言，您可以在相应的源目录中找到有关如何安装该特定语言的 protobuf 运行时的说明：
| 语言 | 来源 |
|---|---|
| C++（包括C++运行时和协议） | 源代码 |
| 爪哇 | 爪哇 |
| Python | Python |
| Objective-C | 目标 |
| C# | 夏普 |
| 红宝石 | 红宝石 |
| 去 | 协议缓冲区/protobuf-go |
| PHP | php |
| 镖 | dart-lang/protobuf |
| JavaScript | 协议缓冲区/protobuf-javascript |
学习如何使用 protobuf 的最佳方法是遵循我们的开发人员指南中的教程。
如果您想从代码示例中学习，请查看示例目录中的示例。
完整的文档可在 Protocol Buffers 文档站点上找到。
了解我们的版本支持政策，以了解语言库的最新支持时间范围。
要了解 Protocol Buffers 即将发生的变化并与 protobuf 开发人员和用户联系，请加入 Google 群组。
