要在 go 中使用 gRPC,需依次安装 protoc 编译器、protoc-gen-go 插件和 gRPC-Go 运行时库,并通过 protoc 命令生成 Go 代码,最后在项目中引入使用。

要在 Go 中使用 gRPC,核心是安装 Protocol Buffers 编译器(protoc)、Go 的 protoc 插件(protoc-gen-go)以及 gRPC-Go 运行时库。整个过程不复杂但容易忽略细节,下面分步说明。
安装 protoc 编译器
protoc 是 google 官方提供的 Protocol Buffers 编译器,用于将 .proto 文件生成 Go 代码。
- linux/macOS:推荐用包管理器安装,例如 macOS 上运行
brew install protobuf;ubuntu/debian 可用sudo apt-get install protobuf-compiler - windows:下载预编译二进制文件(如
protoc-24.3-win64.zip),解压后把bin/protoc.exe加入系统 PATH - 验证是否成功:
protoc --version应输出类似libprotoc 24.3
安装 protoc-gen-go 插件
这是 protoc 的 Go 语言代码生成插件,必须与 protoc 配合使用。
- 执行命令:
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest - 确保
$GOPATH/bin(或 Go 1.18+ 的默认$HOME/go/bin)已加入系统 PATH - 验证:
protoc-gen-go --version应显示版本号(如v1.33.0)
安装 gRPC-Go 运行时库
这是服务端和客户端实际通信依赖的 Go 包,无需全局安装,直接在项目中引入即可。
立即学习“go语言免费学习笔记(深入)”;
- 在项目根目录执行:
go get google.golang.org/grpc@latest - 同时建议获取 proto 运行时支持:
go get google.golang.org/protobuf@latest - 如果使用 gRPC-gateway 或其他扩展,按需添加对应模块(如
google.golang.org/grpc-gateway/v2)
编写并生成 gRPC 代码
完成上述安装后,就可以开始开发了:
- 新建
hello.proto,定义 service 和 message - 运行命令生成 Go 代码:
protoc --go_out=. --go-grpc_out=. hello.proto(注意:gRPC-Go v1.52+ 推荐用--go-grpc_out替代旧的--grpc-gateway_out等) - 生成的
hello.pb.go和hello_grpc.pb.go可直接被 main 包 import 使用
基本上就这些。只要 protoc 和 protoc-gen-go 版本匹配、PATH 设置正确、Go 模块能正常拉取依赖,就能顺利跑起第一个 gRPC 服务。