Go-Zero启动报错根因是GOBIN、GOPATH、GOROOT三者路径错位：GOBIN未入PATH导致goctl不可用；GOPATH与项目位置不一致引发模块解析失败；-f配置路径相对当前工作目录而非项目根目录；GOROOT错误则使工具链失效。
Go-Zero项目在启动时无法读取配置、报错“config file not found”或“listen address invalid”，往往不是代码写错了，而是环境变量没对上服务启动路径——GOBIN、GOPATH、GOROOT三者指向的位置一旦与goctl生成路径、二进制输出路径、配置文件加载路径错位，服务就卡在第一步。
确认GOBIN是否已包含在PATH中
执行 echo $PATH，检查输出中是否包含 $GOPATH/bin 或你自定义的 GOBIN 路径。若没有，后续所有 goctl 生成的命令行工具（如 goctl api go）将无法被识别。
编辑 ~/.bashrc 或 ~/.zshrc，追加：
export GOBIN=$GOPATH/bin
export PATH=$PATH:$GOBIN
【GOBIN 必须显式声明，不能依赖 GOPATH/bin 默认值】 否则 goctl 安装后可能落在系统默认 GOPATH 下，而你当前终端的 GOPATH 已被重定向，导致命令“存在却找不到”。
验证 GOPATH 是否与项目实际位置一致
运行 go env GOPATH，输出路径必须和你的 Go-zero 项目根目录父级保持逻辑一致。例如项目位于 /home/user/myproject，则 GOPATH 应为 /home/user 或 /home/user/go，否则 go run 时会因模块解析失败而报 no required module provides package。
若不一致，立即修正：
export GOPATH=/home/user/go
source ~/.bashrc
这一步不做，后续所有 go mod tidy、go build 都会因模块缓存路径错乱而反复失败。
服务启动时 -f 参数路径必须相对于当前工作目录
方法一：进入项目根目录后启动
cd /path/to/your/project
go run greet.go -f etc/greet-api.dev.yaml
方法二：用绝对路径指定配置文件
go run greet.go -f /path/to/your/project/etc/greet-api.dev.yaml
【-f 后跟的路径是纯字符串拼接，不经过 GOPATH 或 GOBIN 解析】 如果你在 /tmp 目录下执行 go run /home/user/project/greet.go -f etc/greet-api.dev.yaml，程序会去 /tmp/etc/ 找配置，而不是项目目录下的 etc。
方法三（推荐）：在 main.go 中硬编码开发环境配置路径（仅限调试）
将 s := biz.NewServiceOption() 上方插入：
flag.StringVar(&configFile, "f", "etc/greet-api.dev.yaml", "the config file")
区分 GOROOT 与 GOPATH 的职责边界
第一步：确认 GOROOT 指向的是 Go 安装根目录（如 /usr/local/go），不是你的项目目录，也不是 GOPATH 子目录。
第二步：执行 go version -m $(which go)，验证 Go 二进制确实来自 GOROOT/bin/go。
第三步：检查 go env GOROOT 输出是否与 which go 的上级路径完全一致。不一致会导致 go toolchain 加载标准库失败，进而使 go-zero 的 core/logx 等基础包编译报错。
GOROOT 错了，整个 Go 工具链就不可信；GOPATH 错了，项目构建和依赖管理就不可控；GOBIN 错了，goctl 就成了摆设——三者缺一不可，且必须彼此对齐。
