Go Modules 初始化失败主因是路径推断错误或残留文件干扰，应清理后显式指定module path；go get版本不生效因默认升级而非锁定，需确认tag存在或强制commit；vendor需配合-mod=vendor构建且定期更新；replace与exclude共存时顺序和版本号须谨慎处理。
Go 环境现在基本不用手动配 GOPATH，但 GOROOT 和代理配置仍可能出错，尤其在国内网络下——go run 卡住、go get 报 403 或 timeout，八成是代理或权限问题。
go version 命令无效或报“command not found”
说明系统根本找不到 go 可执行文件，不是安装失败，而是 PATH 没生效。
- Windows：检查系统环境变量里
Path是否包含C:\Go\bin（默认路径），改完要重启命令行或终端 - macOS/Linux：确认你编辑的是当前 shell 的配置文件（
~/.zshrc用得最多，不是~/.bash_profile）；运行source ~/.zshrc后再试，别只改不 reload - Linux 手动解压安装时，常见错误是把
go目录放到了/home/user/go，却把PATH指向了/usr/local/go/bin——路径必须严格匹配实际位置
go run main.go 卡住或超时
这不是代码问题，而是模块依赖下载被墙，尤其是首次运行含 import 的程序时，go 会自动触发 go mod download。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐），避免用默认的https://proxy.golang.org - 如果公司内网禁外网，可临时关代理：
go env -w GOPROXY=off，但需确保本地有对应 module 缓存 - 某些 IDE（如旧版 Goland）会自带 GOPROXY 设置，优先级高于命令行，可在 Settings → Go → GOPROXY 里检查
macOS M1/M2 上 go build 失败提示 “incompatible architecture”
现象是 go build 成功但运行时报 dyld 错误，或 cgo 相关包编译失败，本质是二进制目标架构不匹配。
立即学习“go语言免费学习笔记（深入）”；
- 不要依赖 Rosetta 运行
go工具链——装 ARM64 版本（官网下载页明确标 “Apple Silicon” 的.pkg或darwin-arm64包） - 验证是否真跑在 arm64：
go version输出应含darwin/arm64，而非darwin/amd64 - cgo 项目若调用 C 库（如 sqlite），需确保该库也是 arm64 架构；可用
file /path/to/libxxx.dylib查看，否则加CGO_ENABLED=0强制纯 Go 模式编译
第一个程序能跑，但 go mod init 报错 “cannot determine module path”
这是新手最常忽略的路径问题：Go Modules 要求项目目录不能在 $GOPATH/src 下（旧习惯容易踩坑），且目录名不能含空格或中文。
- 新建项目务必在任意非
GOPATH路径下，比如~/projects/hello，而不是~/go/src/hello -
go mod init后面必须跟一个合法 module 名，通常是域名反写或项目名，如go mod init example.com/hello或go mod init hello - 如果当前目录名是
my project，go mod init会因空格失败，改名再试
真正麻烦的从来不是装 Go，而是不同系统对 PATH、GOPROXY、架构和模块路径的隐式要求——它们不报错，只沉默卡住或静默失败。动手前先敲 go env 看一眼输出，比重装三遍更省时间。
