go-zero/tools/goctl/rpc/example/README-cn.md

RPC 示例

English | 中文 | 한국어

本目录包含所有 goctl rpc 代码生成场景的完整示例。

每个示例包含：

• .proto 源文件
• README.md（英文）、README-cn.md（中文）和 README-ko.md（한국어）文档

示例列表

#	目录	场景	关键标志
01	01-basic	基础单服务，无导入	—
02	02-import-sibling	导入同级 proto 文件	--proto_path=.
03	03-import-subdir	导入子目录中的 proto	--proto_path=.
04	04-transitive-import	传递性导入（A → B → C）	--proto_path=.
05	05-multiple-services	单 proto 多服务	--multiple
06	06-wellknown-types	消息中使用 Google 标准类型	—
07	07-external-proto-same-pkg	外部 proto，相同 go_package	-I ./ext_protos
08	08-external-proto-diff-pkg	外部 proto，不同 go_package	-I ./ext_protos
09	09-google-types-as-rpc	Google 标准类型作为 RPC 参数	—
10	10-streaming	服务端/客户端/双向流	—

前置条件

• Go 1.22+
• protoc（Protocol Buffers 编译器）
• protoc-gen-go 和 protoc-gen-go-grpc
• goctl

快速开始

# 安装 protoc 插件
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

# 试试基础示例
cd 01-basic
mkdir -p output && cd output && go mod init example.com/demo && cd ..
goctl rpc protoc greeter.proto \
  --go_out=output --go-grpc_out=output --zrpc_out=output \
  --go_opt=module=example.com/demo --go-grpc_opt=module=example.com/demo \
  --module=example.com/demo -I .