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

示例 04：传递性导入

本示例演示 proto 的传递性导入，即 A 导入 B，B 导入 C。

Proto 定义

三个 proto 文件形成传递导入链，共享相同的 go_package：

option go_package = "example.com/demo/pb";

• base.proto — C 层：定义基础类型（BaseResp）。
• middleware.proto — B 层：导入 base.proto，定义 RequestMeta。
• main.proto — A 层：导入 middleware.proto，定义 PingService（入口文件）。

导入链：main.proto → middleware.proto → base.proto

生成命令

首先，在输出目录中初始化 go.mod：

mkdir -p output && cd output && go mod init example.com/demo && cd ..

然后生成代码：

goctl rpc protoc main.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 .

生成的目录结构：

output/
├── etc
│   └── pingsvc.yaml
├── go.mod
├── internal
│   ├── config
│   │   └── config.go
│   ├── logic
│   │   └── pinglogic.go
│   ├── server
│   │   └── pingserviceserver.go
│   └── svc
│       └── servicecontext.go
├── pb
│   ├── base.pb.go
│   ├── main.pb.go
│   ├── main_grpc.pb.go
│   └── middleware.pb.go
├── pingservice
│   └── pingservice.go
└── pingsvc.go

要点说明

• 三个 proto 文件（base.proto → middleware.proto → main.proto）形成传递导入链。
• goctl 自动递归解析所有传递导入。
• 三个文件共享相同的 go_package = "example.com/demo/pb"。
• 只需指定入口 proto 文件，goctl 和 protoc 会自动处理其余部分。
• 循环导入会被检测并报错（与 protoc 行为一致）。