Protocol Buffers 是由 Google 所推出的一格式（後台真硬），你可以把它想像成是 XML 或 JSON 格式，但是更小、更快，而且更簡潔。這能夠幫你節省網路與硬體資源，且你只需要定義一次資料結構，接著就會自動生成符合你程式語言的檔案，讓你能夠直接在你的程式上使用。
而且有趣的是一但你定義了資料結構，你就能在多個語言上使用，像是 C++、C#、Go、Java、Python、JavaScript?等，如此一來就不用像 JSON 那樣到不同語言時還要重新定義資料結構。
結構就是文件
首先在傳遞資料前，我們需要定義資料結構。這些檔案以 .proto 作為後輟，有趣的是這些檔案本身就是結構定義檔，所以就不用額外撰寫 API 文件，因為 .proto 檔本身就是一種「文件」。
// 撰寫格式是 Proto v3。
syntax = "proto3";
// User 帶有使用者資料，如帳號、密碼。
message User {
string username = 1;
string password = 2;
}
// Post 帶有文章資料。
message Post {
int64 id = 1;
string content = 2;
}
在 Protocol Buffers 中會需要定義資料型態，這讓你明白你應該要傳入什麼類型的資料，這些資料型態可以在這個頁面找到。
後面的數字是什麼？
你可能會好奇為什麼我們需要在每個欄位後面標註數字，實際上這是 Protocol Buffers 編碼與解碼所會用到的編號，這令你能夠移除其中一個欄位而不打亂整個資料結構的編碼與解碼（除非你更改了數字編號）。
與 JSON 比較？
與 JSON 比較，Protocol Buffers 有這些優點。
message User {
string username = 1;
string password = 2;
}
- 資料輕量化：資料非常輕量，省去了不必要的
{或:累贅。 - 混淆性：在一般人眼中無法輕易地猜測出資料結構為何，因為有經過編碼。
- 效能高：處理速度很快。
- 極具方便性：結構就是你的資料模型，你能夠直接在程式中使用這些結構，而不用建立新的物件來接納、映射（Mapping）這些資料。
- 清晰明瞭、無需文件：
.proto檔案本身就是你的文件，不需要額外撰寫 API 或結構文件來告訴別人你接受怎樣的資料。
在行動裝置的應用程式、伺服器與伺服器之間的通訊，或是單頁應用程式都可以用上 Protocol Buffers。
什麼時候應該繼續用 JSON？
當然也不是一味地拋棄 JSON，在有些時候 Protocol Buffers 仍然沒有 JSON 要來地方便。
{
"username": "Yami Odymel",
"password": "test"
}
- 當你希望資料是人類可解讀的時候。
- 你不打算直接把接收到的資料拿來處理，你希望從中拿取部分資料作為處理。
- 你希望在純文字、終端機的情況下就能夠與伺服器溝通。
- 不想經過任何特殊處理，想直接在瀏覽器中解讀。
在傳統網站、小型網站中仍可使用 JSON 作為資料傳遞的格式，如果此時用上 Protocol Buffers 可能會花費過多的時間與開發成本。
傳遞的內容看起來怎樣？
下面這張圖解釋了 Protocol Buffers 傳遞的資料格式。
（圖片來源：https://martin.kleppmann.com/2012/12/05/schema-evolution-in-avro-protocol-buffers-thrift.html）
以最下面的範例結果作為例子，這是 Protocol Buffers 傳遞的內容。Protocol Buffers 位元陣列：
[8 185 96 18 11 89 97 109 105 32 79 100 121 109 101 108 26 4 116 101 115 116]
Protocol Buffers 位元陣列轉為字串：
?`
Yami Odymeltest
解譯成人類可讀：
12345 Yami Odymel test
比起 JSON 的 { 與 : 要來得更加簡潔，並且傳輸時的容量又更小了。
1. 安裝 Protocol Buffers 生成工具
首先需要安裝 protoc，這是用來將 .proto 檔案轉化為程式的工具。先到 Protobuf 的 GitHub 釋出頁面。
滾到最下面，下載符合自己系統的已編譯版本，如此一來就不用再手動編譯。
下載之後解壓縮，然後將 bin/protoc 檔案丟至系統路徑 $PATH，這樣我們就能夠在終端機執行。
2. 安裝 Golang 擴充插件
接下來的教學會以 Golang 為主，其他語言可能要自行參考這裡，首先以 go get 取得 protoc-gen-go
$ go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
這是 protoc 的擴充插件，能夠將程式轉化成 Golang 語言。
接著進到 $GOPATH/bin 中會找到我們剛才下載的 protoc-gen-go 檔案，同樣地，將他丟進系統路徑 $PATH，如此一來才能在稍後於終端機內執行。
3. 轉化 Proto 文件
接著我們要將 .proto 轉化成 Golang 程式才能夠在 Golang 中使用，現在新增下列文件，並且將其命名為 example.proto。
// 撰寫格式是 Proto v3。
syntax = "proto3";
// 生成的程式在 Golang 中將會屬於 `protobuf` 套件。
package protobuf;
// User 帶有使用者資料，如帳號、密碼。
message User {
int64 id = 1;
string username = 2;
string password = 3;
}
然後透過下列指令將 .proto 轉化成 Golang 程式。
$ protoc --go_out=. *.proto
然後我們就能得到一個屬於 protobuf 套件的 example.pb.go 檔案，內容大略如下。
現在我們就可以在 Golang 中開始使用這個結構。
4. 解碼與編碼
記得將我們剛才的 example.pb.go 放至 /protobuf 資料夾內（自行手動新增），因為那個檔案屬於 protobuf 套件。
現在我們要透過這些結構來解碼、與編碼資料（注意：下列範例為了簡潔，都忽略了錯誤處理，這是很不好的行為）。
package main
import (
"fmt"
"./protobuf"
"github.com/gogo/protobuf/proto"
)
func main() {
// 建立一個 User 格式，並在其中放入資料。
data := protobuf.User{
Id: 12345,
Username: "Yami Odymel",
Password: "test",
}
// 將資料編碼成 Protocol Buffer 格式（請注意是傳入 Pointer）。
dataBuffer, _ := proto.Marshal(&data)
// 將已經編碼的資料解碼成 protobuf.User 格式。
var user protobuf.User
proto.Unmarshal(dataBuffer, &user)
// 輸出解碼結果。
fmt.Println(user.Id, " ", user.Username, " ", user.Password)
}
透過下列指令執行。
$ go run main.go
接著我們就能夠得到這樣的結果。
12345 Yami Odymel test
上面這個結果是由資料編碼成 Protocol Buffers 然後解碼所得到的。
from: https://yami.io/protobuf/
原文地址：https://www.cnblogs.com/GarfieldEr007/p/10113322.html