原始緩衝區
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 群組。
