Go-Zero v1.10.0要求最低Go版本为1.23，低于该版本将无法编译或运行时崩溃；需执行go version确认，并配置GO111MODULE=on和GOPROXY；同时必须安装匹配版本的goctl、protoc、protoc-gen-go、protoc-gen-go-grpc四项工具。
Go-Zero对 Go 版本有什么要求
Go-Zero 当前最新稳定版 v1.10.0 明确要求最低使用 Go 1.23，低于该版本将无法编译通过或触发运行时 panic；若你正用 Go 1.22 或更早版本，启动服务时大概率在 init 阶段就因 context.WithCancelCause 等新 API 缺失而直接崩溃。
这一步不能跳过：执行 go version 查看当前版本，输出必须为 go version go1.23.x linux/amd64（或 darwin/amd64、windows/amd64）格式。任何含 1.22、1.21、1.20 的结果都需立即升级。
Go 1.23 安装后，还需运行 go env -w GO111MODULE=on 和 go env -w GOPROXY=https://goproxy.cn,direct，否则后续依赖拉取会失败或超时。
环境依赖逐项核对
go-zero 不是只靠 go install 就能跑起来的单二进制，它依赖四个关键组件协同工作：goctl、protoc、protoc-gen-go、protoc-gen-go-grpc。缺一不可，且版本必须严格匹配。
方法一：用 goctl 自动检测并安装（推荐）
在终端执行：goctl env check -i -f --verbose
该命令会依次检查四项工具是否存在、是否可执行、是否在 $PATH 中，并自动从缓存安装缺失项。注意：-i 参数代表 install，-f 表示 force 覆盖已有旧版，【务必加 -f，否则旧版 protoc-gen-go 可能残留导致生成代码失败】。
方法二：手动验证四项（用于排查故障）
① 检查 goctl：goctl -v → 输出应为 goctl version 1.4.0+（2026年最新为1.4.0）
② 检查 protoc：protoc --version → 必须 ≥ 3.21.12，低于此版本会导致 .api 文件中某些 tag 解析异常
③ 检查 protoc-gen-go：protoc-gen-go --version → 必须与 goctl 所需版本一致，v1.4.0 对应 v1.33.0
④ 检查 protoc-gen-go-grpc：protoc-gen-go-grpc --version → 必须 ≥ v1.3.0，否则 gRPC 接口注册时 panic
执行完任一方法后，最终应看到终端输出：[goctl-env]: congratulations! your goctl environment is ready!
