必须匹配芯片架构：M1/M2/M3需darwin-arm64，Intel需darwin-amd64；uname -m与go version末尾架构不一致时须重装对应包。
go version 输出的架构是否匹配你的 Mac 芯片
这是最容易被跳过的一步，但直接决定后续所有依赖能否编译通过。M1/M2/M3 芯片必须用 darwin-arm64 包，Intel 芯片必须用 darwin-amd64 包。装错会导致 go build 报错：cannot execute binary file: Exec format error 或依赖中 cgo 链接失败。
验证方式很简单：
- 运行
go version，看输出末尾是darwin/arm64还是darwin/amd64 - 运行
uname -m：输出arm64表示 Apple Silicon，x86_64表示 Intel - 两者必须一致；不一致就重装对应架构的包，别硬扛
GO111MODULE=on 且 go.mod 存在时 go list -m all 是否成功
很多项目看似能 go run，但一拉新依赖就卡住或走错路径，根源常是模块模式没真正启用。仅靠 go env GO111MODULE 输出 on 不够——还要验证它在当前目录生效。
操作步骤：
立即学习“go语言免费学习笔记（深入）”；
- 进入项目根目录（确保里面有
go.mod） - 执行
go list -m all，应列出所有依赖及版本，无报错 - 如果报
no required module provides package或not in a module，说明当前目录未被识别为 module 根，可能因GO111MODULE=auto且父目录有go.mod干扰，或 shell 环境未继承变量 - 强制生效：在项目目录下运行
go env -w GO111MODULE=on（仅影响当前用户），再试
GOPROXY 是否生效，特别是国内网络环境下
没配代理时，go get 或 go mod download 经常卡在 Fetching github.com/xxx 10 分钟不动，最后超时失败。这不是环境没装好，而是网络策略导致的假性“不可用”。
验证方法不是只看 go env GOPROXY，而是实测拉取：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐国内用这个） - 新建空目录，执行：
go mod init test && go get github.com/spf13/cobra@v1.8.0 - 成功则立即下载并生成
go.sum；失败则看错误里是否含timeout或connection refused - 若公司内网，需换成自建代理地址，且确认
direct在末尾保留，否则私有模块无法直连
IDE 启动终端和调试器是否读取了正确的 go env
VS Code 或 GoLand 从桌面图标启动时，往往不加载 ~/.zshrc 里的 GOROOT 和 PATH，导致编辑器里 go run 正常，但调试器报 command not found: go，或 go env 显示空 GOROOT。
解决的关键是验证而非猜测：
- 在 VS Code 内置终端中执行
go env GOROOT，对比你 shell 中的输出是否一致 - 打开 Debug 控制台（Run → Open Console），执行同样命令，结果很可能不同
- macOS 下最稳方案：关掉 IDE，从终端执行
code .启动；Windows 下用管理员权限终端启动 Goland - 实在不行，就在
.vscode/settings.json里硬编码："go.goroot": "/usr/local/go"
