go命令找不到或go env异常是PATH未正确配置所致，非安装失败；需将Go的bin目录（如/usr/local/go/bin或C:\Go\bin）加入PATH并source或重启终端，确保go version与go env GOROOT输出一致。
go命令找不到或go env输出异常
这是环境变量配置失败最直接的表现，不是Go没装好，而是系统压根没找到go可执行文件。常见于手动解压官方包后忘了加PATH，或错误覆盖了GOROOT。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认
go二进制真实路径：Linux/macOS执行ls -l /usr/local/go/bin/go，Windows检查C:\Go\bin\go.exe是否存在 - Shell配置文件里只加
PATH，别碰GOROOT：Zsh用户改~/.zshrc，Bash用户改~/.bashrc，追加export PATH="/usr/local/go/bin:$PATH" - Windows务必在「系统属性 → 高级 → 环境变量」中把
C:\Go\bin加入系统级Path（非用户级），否则PowerShell可能读不到 - 改完必须新开终端，再运行
go version和go env GOROOT——两者输出路径必须一致且指向你安装的位置
GOOS/GOARCH设了但编译出的二进制还是不能跑
典型现象是Linux上生成的linux/amd64文件传到目标机报cannot execute binary file，或者Windows上双击.exe无反应。根本原因不是参数没设，而是漏掉了关键开关或平台约束不匹配。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
GOOS和GOARCH必须同时显式设置，缺一不可：单独GOOS=linux会沿用当前机器的GOARCH（比如macOS是arm64），结果得到linux/arm64而非想要的linux/amd64 - Windows目标必须加
-buildmode=exe：Linux/macOS宿主机上构建Windows程序时，默认产出无扩展名的PE文件，双击打不开；正确写法是GOOS=windows GOARCH=amd64 -buildmode=exe go build -o app.exe main.go - 验证支持组合：运行
go tool dist list | grep linux，确认linux/amd64确实在输出里——旧版Go（如1.19之前）对linux/arm等组合支持不全 - 若代码含
// #cgo或依赖github.com/mattn/go-sqlite3，默认CGO_ENABLED=1会导致编译失败或运行时崩溃；此时要么加CGO_ENABLED=0，要么改用Docker构建
go mod download卡住或校验失败
国内环境常卡在golang.org/x/net，离线环境则报verifying github.com/xxx@v1.2.3: checksum mismatch。这不是网络抽风，而是代理策略和校验机制没对齐。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 国内联网：立即执行
go env -w GOPROXY=https://goproxy.cn,direct（七牛源）或go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct（清华源） - 私有Git仓库（如
git.example.com）必须加go env -w GOPRIVATE=git.example.com，否则代理会拦截请求并返回404 - 离线环境：提前在联网机器执行
go mod download，打包整个$GOPATH/pkg/mod目录；目标机上运行go env -w GOPROXY=direct GOSUMDB=off - 别信
go clean -modcache能解决一切——它清的是本地缓存，不影响远程代理行为；真正要清的是模块索引，需配合go env -u GOPROXY重置
跨平台构建后资源文件或路径失效
二进制能在目标机运行，但读不到config.yaml、打不开embed.FS里的模板，或日志路径错乱。这不是Go编译问题，而是开发时路径处理没做抽象。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 绝对禁止字符串拼接路径：
"config/" + env + ".yaml"在Windows上会变成configdev.yaml；必须用filepath.Join("config", env+".yaml") - 嵌入资源（
embed.FS）的键名永远是POSIX风格（/分隔），读取时需统一转义：fs.ReadFile(fsys, filepath.ToSlash(path)) - 配置文件、静态资源、动态库这些不会随二进制自动打包，必须手动分发，并在代码中用相对路径加载（如
./assets/logo.png） - 若用
os.Executable()推导配置路径，注意它返回的是二进制所在目录，不是项目根目录；跨平台部署时该路径可能不存在或权限受限
CGO_ENABLED=0下会静默降级，且不同平台表现不一致。 
