首先安装protoc编译器及Go插件,然后编写helloworld.proto定义服务接口和消息类型,接着运行protoc命令生成helloworld.pb.go和helloworld_grpc.pb.go两个文件,最后在Go代码中实现服务端GreeterServer接口和客户端调用逻辑,启动服务并通信。

在Go语言中使用gRPC进行服务通信,需要通过Protocol Buffers(简称protobuf)定义接口和服务结构,再利用protoc编译器和插件生成客户端与服务端的Go代码。下面详细介绍从定义proto文件到生成gRPC代码的完整流程。
1. 安装必要的工具和依赖
要生成gRPC代码,必须先安装以下组件:
- protoc编译器:用于解析.proto文件并生成基础代码。
-
Go插件:
protoc-gen-go和protoc-gen-go-grpc,分别用于生成Go结构体和gRPC服务代码。
执行以下命令安装Go相关插件:
go install google.golang.org/protobuf/cmd/protoc-gen-go@latestgo install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
确保$GOPATH/bin已加入系统PATH,否则protoc无法找到这些插件。
立即学习“go语言免费学习笔记(深入)”;
2. 编写.proto文件定义服务
创建一个helloworld.proto文件,定义简单的问候服务:
option go_package = "./;pb";
package helloworld;
// 定义服务
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply);
}
// 请求消息
message HelloRequest {
string name = 1;
}
// 响应消息
message HelloReply {
string message = 1;
}
go_package指定生成代码的包路径和包名,这里设为当前目录,包名为pb。
3. 使用protoc生成Go代码
在.proto文件所在目录运行以下命令:
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
helloworld.proto
执行后会生成两个文件:
-
helloworld.pb.go:包含消息类型的Go结构体和序列化方法。 -
helloworld_grpc.pb.go:包含客户端接口和服务端抽象接口。
生成的代码中,服务端需实现GreeterServer接口,客户端可直接调用GreeterClient接口。
4. 实现服务端与客户端逻辑
服务端示例:
package mainimport (
"context"
"log"
"net"
"google.golang.org/grpc"
pb "your-module/pb"
)
type server struct {
pb.UnimplementedGreeterServer
}
func (s *server) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
return &pb.HelloReply{Message: "Hello " + req.Name}, nil
}
func main() {
lis, err := net.Listen("tcp", ":50051")
if err != nil {
log.Fatalf("failed to listen: %v", err)
}
s := grpc.NewServer()
pb.RegisterGreeterServer(s, &server{})
log.Println("gRPC server running on :50051")
s.Serve(lis)
}
客户端示例:
package mainimport (
"context"
"log"
"google.golang.org/grpc"
"google.golang.org/grpc/credentials/insecure"
pb "your-module/pb"
)
func main() {
conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil {
log.Fatal(err)
}
defer conn.Close()
client := pb.NewGreeterClient(conn)
resp, err := client.SayHello(context.Background(), &pb.HelloRequest{Name: "Alice"})
if err != nil {
log.Fatal(err)
}
log.Println(resp.Message)
}
运行服务端后,执行客户端即可看到输出:Hello Alice。
基本上就这些。只要定义好proto文件,gRPC能自动生成高效、类型安全的通信代码,极大简化远程调用开发。注意保持proto与生成代码同步,并合理组织模块路径。










