【Golang | gRPC】使用protoc编译.proto文件

环境: Golang: go1.18.2 windows/amd64 protoc:libprotoc 3.21.1

1. 安装protoc

使用protoc编译.proto文件,首先需要正确安装protoc编译器。如果使用预编译的二进制文件方式安装,注意添加环境变量,具体可以参考

2. 安装针对go的protoc插件

protoc本身并不支持Golang,需要额外安装对应的插件 方法1,使用go install <module>@latest安装

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

方法2,在一个已经包含go.mod文件的项目里使用go get <module>

go get google.golang.org/protobuf/cmd/protoc-gen-go
go get google.golang.org/grpc/cmd/protoc-gen-go-grpc

安装成功后,会在$GOPATH/bin目录下生成两个2进制文件

    protoc-gen-go protoc-gen-go-grpc

注: 这时候执行protoc --go_out=. --go-grpc_out=. *.proto时,可能出现--go_out: protoc-gen-go: Plugin failed with status code 1的报错,这是由于$GOPATH/bin目录没有添加到系统环境变量里。

3. 实践

3.1 准备一个.proto文件

3.1.1 新建gRPC项目,使用go mod init初始化,创建pb文件夹,新建hello.proto文件 3.1.2 指定syntax,package,option go_package,分别代表protobuf版本,包名,编译生成的.pb.go文件目录

syntax = "proto3";
package pb;
option go_package = "./shannont/hello";

注:

    option go_package这个配置项当前版本尽量带上,否则编译时会报错(M参数代表什么没有找到相关文档)
Please specify either:
        • a "go_package" option in the .proto source file, or
        • a "M" argument on the command line.
    option go_package = "./shannont/hello";代表在protoc编译时,在--go_out(见3.2)指定的目录下自动生成shannont/hello文件夹,同时在该文件夹下生成的.pb.go文件的包名是hello; 可以通过如下格式指定包名option go_package = "./shannont/hello;helloRename";,此时;前含义同上,;后表示生成的.pb.go文件的包名是helloRename

3.1.3 定义service和message

    service对应golang中的接口 message对应golang中的结构体
// The greeter service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// The request message containing the users name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

3.2 使用protoc编译

在gRPC/pb目录下使用如下命令进行编译 protoc --go_out=. --go-grpc_out=. ./hello.proto,生成对应的.pb.go和_grpc.pb.go两个文件,前者主要是对message生成对应的结构体和方法,后者生成gRPC,主要是对service生成对应的interface和方法

    go_out=. 指定生成的pb.go文件所在目录(如果没有该目录,需要手动提前创建),.代表当前protoc执行目录,结合.proto文件中的option go_package,其最终的生成文件目录为go_out指定目录/go_package指定目录 go-grpc_out针对_grpc.pb.go文件,作用同上 另外官网文档里还有一个--go_opt=paths=source_relative,其含义代表生成的.pb.go文件路径不依赖于.proto文件中的option go_package配置项,直接在go_out指定的目录下生成.pb.go文件(.pb.go文件的package名还是由option go_package决定) --go-grpc_opt=paths=source_relative,针对_grpc.pb.go文件,作用同上

4. 总结

    模块github.com/golang/protobuf由google.golang.org/protobuf"取代 当前版本编译时,之前的方法protoc --go_out=plugins=grpc:. *.proto不再使用,转而用protoc --go_out=. --go-grpc_out=. ./hello.proto代替。有如下提示
PS C:Users	ianwanshanGolandProjectsGolangLearningRPCgRPCpb> protoc --go_out=plugins=grpc:. *.proto
--go_out: protoc-gen-go: plugins are not supported; use protoc --go-grpc_out=... to generate gRPC
经验分享 程序员 微信小程序 职场和发展