- 简介:
- Protobuf是Protocol Buffers的简称,它是Google公司开发的一种数据描述语言,是一种轻便高效的结构化数据存储格式,可以用于结构化数据串行化,即序列化。它很适合做数据存储或 RPC 数据交换格式。可用于通讯协议、数据存储等领域的语言无关、平台无关、可扩展的序列化结构数据格式。目前提供了 C++、Java、Python 三种语言的 API。
- 类似于json一样的数据描述语言
- 非常适合于RPC数据交换格式
- 优势:
- 序列化后体积相对于JSON和XML比较小,适用于网络传输
- 支持跨平台多语言
- 消息格式升级和兼容性好
- 序列化和反序列化处理速度比JSON快
- 劣势:
- 相对于JSON和XML应用不够广
- 二进制格式,可读性差
- 缺少自描述
- brew安装
# 查看protobuf信息
brew info protobuf
# 安装
brew install protobuf
# 检查安装结果/protobuf版本
protoc --version
# 测试protobuf编译工具
protoc -h
- golang安装protobuf插件
- protobuf并没有直接支持golang语言,需要我们手动安装插件
- protobuf插件安装方法一:
# go get 可能出现超时情况
go get -u -v github.com/golang/protobuf/proto
go get -u -v github.com/golang/protobuf/protoc-gen-go
# protoc需要依赖调用protoc-gen-go,它的路径必须要添加到环境变量中$GOPATH/bin。
-
- protobuf插件安装方法二:
- GitHub - golang/protobuf: Go support for Google's protocol buffersGo support for Google's protocol buffers. Contribute to golang/protobuf development by creating an account on GitHub.
https://github.com/golang/protobuf
- 下载protobuf插件的zip包protobuf-master.zip
- 解压到 $GOPATH/src/github.com/golang目录中,并且重新命名为protobuf
- 进入到文件夹内进行编译
- GitHub - golang/protobuf: Go support for Google's protocol buffersGo support for Google's protocol buffers. Contribute to golang/protobuf development by creating an account on GitHub.
- protobuf插件安装方法二:
cd $GOPATH/src/github.com/golang/protobuf/protoc-gen-go
go build
-
-
- 将生成的 protoc-gen-go可执行文件,放在/bin目录下
-
sudo cp protoc-gen-go $GOROOT/bin
-
-
- 尝试补齐protoc-gen-go,确定是否安装成功
-
- 使用示例:
//默认是proto2
syntax = "proto3";
option go_package="./;pd";
package pd;
//定义枚举类型
enum Week {
Monday = 0;//枚举值必须从0开始
Turesday = 1;
}
//定义消息体
message Student {
int32 age = 1; //可以不从1开始,但是不能重复,不能使用19000-19999
string name = 2;
People p = 3;
repeated int32 score = 4;//数组
//枚举
Week w = 5;
//联合体
oneof data {
string teacher = 6;
string class = 7;
}
}
//嵌套消息体
message People {
int32 weight = 1;
}
- protoc编译:protoc --go_out=./ *.proto
- protoc编译异常错误解决
- 错误内容:protoc-gen-go: unable to determine Go import path for
- 解决方法
-
- 添加代码段:option go_package="./;pd";制定go文件的存放地址和包名