go命令找不到、编译失败、依赖拉不下来，90%是迁移后path或goroot未对齐：path必须包含$goroot/bin而非$goroot本身，goroot目录下需完整存在bin/src/pkg，国内还需配置goproxy=https://goproxy.cn,direct。
Go 命令找不到、程序编译失败、依赖拉不下来——90% 是迁移后 PATH 或 GOROOT 没对齐，不是代码或版本问题。
go: command not found —— PATH 指向了错误的 bin 目录
迁移环境（比如从 macOS 切到 Linux，或重装系统）后敲 go version 报错，第一反应不是重装 Go，而是检查 PATH 是否包含正确的 bin 子目录：
-
GOROOT是安装根目录（如/usr/local/go），PATH 必须加的是$GOROOT/bin，不是$GOROOT本身 - Linux/macOS 用户查配置文件：
grep "export PATH" ~/.zshrc ~/.bashrc 2>/dev/null，确认有类似export PATH=$PATH:/usr/local/go/bin的行 - 改完必须运行
source ~/.zshrc（Zsh）或source ~/.bashrc（Bash），否则 shell 不会重新加载 - 验证是否生效：
echo $PATH | grep -o "/usr/local/go/bin"，有输出才算成功
go run 无输出或 panic: cannot find package "fmt"
命令能执行但标准库报错，说明 GOROOT 指向了一个不完整的目录——常见于手动解压时只复制了 bin/，漏了 src/ 和 pkg/：
- 运行
go env GOROOT，拿到路径后进该目录，执行ls -d bin src pkg，三个都得存在 - 若缺
src/，别试图从别的 Go 安装里拷，直接删掉整个目录，用官方 tar.gz 重装：tar -C /usr/local -xzf go1.22.4.linux-amd64.tar.gz - 验证标准库是否可读：
go list std | head -5应快速列出包名；若卡住或报can't load package，大概率是src/权限不对或损坏
go mod download 卡住或报 “version not found”
本地 go version 正常、go env 看起来也没问题，但模块就是拉不下来，重点查网络代理和模块路径一致性：
- 国内用户必须设代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则golang.org/x/...类模块必挂 - 私有仓库（如公司 Git）要加
go env -w GOPRIVATE=git.example.com，否则代理会拦截请求并返回 403 - 想确认某个 tag 是否真存在，不用猜，直接 curl：
curl -I https://goproxy.cn/github.com/your/repo/@v/v1.2.3.info，返回 200 才算可拉取 - 如果
go list -m all显示了版本，但go get @v1.2.3没反应，说明 MVS 已锁定更高版本，需用go mod edit -require=github.com/your/repo@v1.2.3强制写入
GoLand 提示 “not a valid home for Go SDK”
终端里 go version 正常，但 IDE 死活认不出 SDK，问题往往出在版本校验逻辑上，而非路径填错：
- GoLand（尤其 ≤ 2023.3）会读
$GOROOT/src/runtime/internal/sys/zversion.go里的TheVersion常量，而 Go 1.17+ 默认不生成该文件 - 若文件不存在，手动创建：
mkdir -p $GOROOT/src/runtime/internal/sys，然后新建zversion.go，内容仅两行：package sys和const TheVersion = `go1.22.4`（版本号必须和go version输出一致） - 保存后必须彻底退出 GoLand 再重开，它不会热加载这个文件
- Windows 用户额外注意：GOROOT 路径不能以反斜杠结尾（
C:\Go\错，C:\Go对），也不能含空格
迁移的本质不是“复制文件”，而是让每个环节（shell、IDE、代理、模块解析）看到同一套真实路径和权限。最易被忽略的点是：go env 输出的值 ≠ 你 echo $GOROOT 看到的值，也不等于 IDE 设置框里填的字符串——它只认最终合并后的结果，所以排查永远从 go env 开始，而不是从配置文件开始。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
