+
+
+
+
+
+
+ Proto 文件
+
+
+
+ Message
+
+
+
+ Service
+
+
+
+ 依赖
+
+
+
+ 插件
+
+
+
+ 总行数
+
+
+
+
+ ⚡ 快速操作
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 运行中...
+
+ 命令输出
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 依赖存放的目录
+
+
+
+
+
+
+ 插件生成代码的默认目录
+
+
+
+
+
+
+ protoc 路径模式
+
+
+
+
+ Go 模块路径
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Proto 依赖
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 暂无依赖配置，点击"添加依赖"开始
+
+
+
+
+
+
+
+
+ Protoc 插件
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 已禁用
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 暂无插件配置，点击上方按钮添加
+
+
+
+ 插件安装器
+通过 go install 安装的插件列表
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Linter 配置
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 💡 常用规则
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 📁 文件浏览器
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 暂无 Proto 文件
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 选择文件以查看内容
+
+
+ messages
+ services
+ imports
+ lines
+
+
+
+
+
+
+
+
+ 👈 从左侧选择文件查看
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ YAML 配置预览
+ +
+
+ 📚 配置示例参考
+以下是常用的配置示例，点击「应用此配置」可直接使用。
+ +
+
+
+
+
+
+
+
+
+
+
+
+ 🚀 基础 Go 项目
+适合简单的 Go + gRPC 项目
+vendor: .proto +base: + out: ./gen + paths: source_relative +root: + - proto +includes: + - proto +deps: + - name: google/protobuf + url: https://github.com/protocolbuffers/protobuf + path: src/google/protobuf +plugins: + - name: go + - name: go-grpc+
+
+
+
+
+
+
+
+
+ ⚡ 完整项目配置
+包含 gRPC-Gateway、Validate、OpenAPI 等
+vendor: .proto +base: + out: ./pkg + paths: import + module: github.com/yourorg/yourproject/pkg +root: + - proto + - api +includes: + - proto + - third_party +deps: + - name: google/protobuf + url: https://github.com/protocolbuffers/protobuf + path: src/google/protobuf + - name: google/api + url: https://github.com/googleapis/googleapis + path: google/api + - name: protoc-gen-openapiv2/options + url: https://github.com/grpc-ecosystem/grpc-gateway + path: protoc-gen-openapiv2/options + - name: validate + url: https://github.com/bufbuild/protovalidate + path: proto/protovalidate/buf/validate +plugins: + - name: go + - name: go-grpc + - name: grpc-gateway + opt: + - generate_unbound_methods=true + - name: openapiv2 + out: ./docs/swagger + - name: validate-go +linter: + format_type: github_actions + rules: + enabled_rules: + - core + - naming + disabled_rules: []+
+
+
+
+
+
+
+
+
+ 🔧 微服务项目
+适合多模块微服务架构
+vendor: .proto +base: + out: ./internal/pb + paths: import + module: github.com/yourorg/service/internal/pb +root: + - api/proto +includes: + - api/proto + - vendor/proto +excludes: + - vendor + - third_party +deps: + - name: google/protobuf + url: https://github.com/protocolbuffers/protobuf + path: src/google/protobuf + - name: google/api + url: https://github.com/googleapis/googleapis + path: google/api +plugins: + - name: go + opt: + - paths=source_relative + - name: go-grpc + opt: + - paths=source_relative + - require_unimplemented_servers=false + - name: connect-go + out: ./internal/connect +linter: + format_type: yaml + rules: + enabled_rules: + - core::0131::http-method + - core::0131::http-body + disabled_rules: + - all+
+
+
+
+
+
+
+
+
+ 🏷️ 自定义结构体标签
+使用 retag 添加 JSON/XML/Validate 标签
+vendor: .proto
+base:
+ out: ./pkg
+ paths: import
+ module: github.com/yourorg/yourproject/pkg
+root:
+ - proto
+includes:
+ - proto
+deps:
+ - name: google/protobuf
+ url: https://github.com/protocolbuffers/protobuf
+ path: src/google/protobuf
+ - name: retag
+ url: https://github.com/pubgo/protoc-gen-retag
+ path: proto/retag
+plugins:
+ - name: go
+ - name: retag
+# Proto 文件中使用示例:
+# message User {
+# string id = 1 [(retag.tags) = {name: "json", value: "user_id"}];
+# string email = 2 [
+# (retag.tags) = {name: "json", value: "email"},
+# (retag.tags) = {name: "xml", value: "email,attr"},
+# (retag.tags) = {name: "validate", value: "required,email"}
+# ];
+# }
+
+
+
+
+
+
+
+
+
+ 📦 Buf 兼容配置
+与 Buf Schema Registry 集成
+vendor: .proto +base: + out: ./gen/go + paths: source_relative +root: + - proto +includes: + - proto +deps: + - name: buf/validate + source: buf.build + url: buf.build/bufbuild/protovalidate + - name: googleapis + source: buf.build + url: buf.build/googleapis/googleapis +plugins: + - name: go + - name: go-grpc + - name: buf-validate-go +installers: + - go install google.golang.org/protobuf/cmd/protoc-gen-go@latest + - go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest + - go install github.com/bufbuild/buf/cmd/buf@latest+
+
+
+
+
+
+
+ 🌐 多语言生成
+同时生成 Go、TypeScript、Python 代码
+vendor: .proto +root: + - proto +includes: + - proto +deps: + - name: google/protobuf + url: https://github.com/protocolbuffers/protobuf + path: src/google/protobuf +plugins: + # Go + - name: go + out: ./gen/go + opt: + - paths=source_relative + - name: go-grpc + out: ./gen/go + opt: + - paths=source_relative + # TypeScript (使用 ts-proto) + - name: ts_proto + out: ./gen/ts + opt: + - esModuleInterop=true + - outputServices=grpc-js + # Python + - name: python + out: ./gen/python + - name: grpc_python + out: ./gen/python +installers: + - go install google.golang.org/protobuf/cmd/protoc-gen-go@latest + - go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest + - npm install -g ts-proto + - pip install grpcio-tools+