必须安装goctl工具才能生成Go-Zero项目结构等；推荐用go install命令安装，失败时需将$GOPATH/bin加入PATH；也可用goctl env check自动检测安装；离线环境可手动下载对应平台预编译二进制文件。
要在本地快速生成 Go-Zero 项目结构、API 文件、RPC 代码或数据库模型，必须先安装 goctl 这个核心命令行工具；它不随 Go-Zero 框架自动安装，需单独获取并确保能被系统识别为可执行命令。
方式一：go install 直接安装（推荐）
打开终端，执行以下命令：
go install github.com/zeromicro/go-zero/tools/goctl@latest
这一步会从 GitHub 拉取最新版 goctl 源码，编译后放入 $GOPATH/bin 目录。Go 1.16+ 默认启用 module，无需额外设置 GO111MODULE。
安装完成后，运行 goctl --version 验证——如果提示 command not found，说明 【$GOPATH/bin 未加入 PATH 环境变量】，需手动配置。
方式二：使用 goctl env check 一键检测并安装
该命令会自动检查缺失依赖（包括 protoc、protoc-gen-go、goctl），并尝试补全：
goctl env check -i -f --verbose
注意：此命令要求本地已安装 Go 且 go 命令可用；它内部调用 go install，但会自动处理 GOPROXY 和模块开关，适合网络受限或对环境变量不熟悉的用户。
执行后若看到 goctl installed successfully，即可直接使用。
方式三：macOS/Linux 下手动下载预编译二进制
适用于无法运行 go install 的离线环境或某些 ARM 架构机器：
① 访问 go-zero GitHub Releases 页面，找到最新版本的 goctl-darwin-arm64（Mac M 系列）、goctl-darwin-amd64（Intel Mac）或 goctl-linux-amd64（Linux x86_64）文件。
② 下载后解压，得到单个 goctl 可执行文件。
③ 将其移至 $GOPATH/bin 或 /usr/local/bin，并赋予执行权限：chmod +x goctl && sudo mv goctl /usr/local/bin/
这一步跳过了 Go 编译环节，但后续升级需重复下载替换——【不可跨平台混用二进制文件】，比如 Linux 二进制不能在 macOS 上运行。
