Go-Zero微服务启动前必须安装protoc、protoc-gen-go和protoc-gen-go-grpc三者缺一不可；推荐用goctl env check -i -f --verbose一键检测并安装，或按平台手动安装protoc及两个Go插件。
Go-Zero微服务项目启动前必须让protoc和protoc-gen-go可用，否则执行goctl rpc protoc时会直接报错退出——这不是配置问题，是工具链根本没闭环，缺一不可。
用 goctl 一键检测并安装（推荐新手）
这一步操作起来很简单，直接在终端运行即可，goctl会自动识别缺失项并从缓存安装：
【必须在项目根目录或任意空目录下执行】：goctl env check -i -f --verbose
命令会依次检查protoc、protoc-gen-go、protoc-gen-go-grpc是否存在；若未找到，自动下载对应平台二进制或插件到$GOBIN（通常是$GOPATH/bin）；最后输出“congratulations! your goctl environment is ready!”即完成。
注意：该命令不会覆盖已存在但版本过旧的插件，如需强制更新，请先手动删除旧版再运行。
手动安装 protoc（跨平台）
protoc是C++编写的独立二进制，必须本地可执行，不能靠go install生成。
macOS用户执行：brew install protobuf
Ubuntu/Debian用户执行：sudo apt install protobuf-compiler
Windows用户需前往 https://github.com/protocolbuffers/protobuf/releases 下载最新protoc-xx.x-win64.zip，解压后将bin/protoc.exe路径加入系统PATH环境变量。
验证是否生效：运行protoc --version，输出形如libprotoc 21.12。若提示command not found，请确认PATH是否生效（新开终端）；若提示permission denied（macOS），右键→“显示简介”→勾选“始终允许”或终端执行xattr -d com.apple.quarantine /path/to/protoc。
手动安装 protoc-gen-go 和 protoc-gen-go-grpc
这两个是Go语言专用插件，必须用go install安装，【go get已弃用，Go 1.17+ 不再支持】。
方法一（安装最新稳定版）：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
方法二（指定兼容go-zero的版本，推荐）：
先查当前go-zero版本：goctl -v → 记下版本号（如v1.6.0）；再访问 https://github.com/zeromicro/go-zero/releases 查看其兼容的protoc-gen-go范围；例如v1.6.0要求protoc-gen-go ≥ v1.32.0，则执行：
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.32.0
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.3.0
安装完成后，运行protoc-gen-go --version和protoc-gen-go-grpc --version，两者都应有输出；若提示command not found，检查$GOBIN是否在PATH中（通常为$GOPATH/bin或$HOME/go/bin）。
