首页 > Golang > Go教程

GolanggRPC代码生成实战教程

时间：2026-01-23 12:59:35 452浏览收藏

大家好，我们又见面了啊~本文《Golang gRPC生成客户端服务端代码实践》的内容中将会涉及到等等。如果你正在学习Golang相关知识，欢迎关注我，以后会给大家带来更多Golang相关文章，希望我们能一起进步！下面就开始本文的正式内容~

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

Golang如何使用gRPC生成客户端与服务端代码_Golang gRPC客户端服务端生成实践详解

在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@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

确保$GOPATH/bin已加入系统PATH，否则protoc无法找到这些插件。

2. 编写.proto文件定义服务

创建一个helloworld.proto文件，定义简单的问候服务：

syntax = "proto3";

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文件所在目录运行以下命令：

protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
helloworld.proto

执行后会生成两个文件：

helloworld.pb.go：包含消息类型的Go结构体和序列化方法。
helloworld_grpc.pb.go：包含客户端接口和服务端抽象接口。

生成的代码中，服务端需实现GreeterServer接口，客户端可直接调用GreeterClient接口。

4. 实现服务端与客户端逻辑

服务端示例：

package main

import (
"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 main

import (
"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与生成代码同步，并合理组织模块路径。

今天关于《GolanggRPC代码生成实战教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

前往漫画官网入口并下载 ➜