Go命令找不到的最直接原因是PATH未正确配置，需确认安装路径（如/usr/local/go/bin或C:\Go\bin）并添加到对应shell配置文件（如~/.zshrc）或Windows环境变量，再source或重启终端验证。
go命令找不到：PATH没配对是最直接的信号
安装完 Go 后输入 go version 报 command not found: go，基本就是 PATH 没生效。这不是 Go 没装好，是系统压根没找到它。
先确认 Go 真实安装位置：
- macOS/Linux 默认是
/usr/local/go（官网 .tar.gz 安装）或/opt/homebrew/Cellar/go/1.25.x/bin/go（Homebrew 安装） - Windows 默认是
C:\Go\bin\go.exe（.msi 安装）或你自定义的路径如D:\Go\bin\go.exe
再检查对应 shell 配置文件是否加了正确路径：
- Zsh（macOS Catalina+ / 多数 Linux）：编辑
~/.zshrc，加export PATH="/usr/local/go/bin:$PATH" - Bash：编辑
~/.bashrc或~/.bash_profile，同样加路径 - Windows：系统属性 → 高级 → 环境变量 → 用户变量或系统变量中，把
C:\Go\bin或你的Go\bin目录加进Path
改完别忘了重载：source ~/.zshrc（或对应文件），再跑一次 go version。如果还是报错，用 which go（macOS/Linux）或 where go（Windows）看系统到底在找哪个路径 —— 很可能 PATH 里混进了旧版本残留路径。
立即学习“go语言免费学习笔记（深入）”；
go get 报 failed to load mod file：不是模块问题，是当前没模块
GO111MODULE=on 是默认行为，但 go get 不会帮你自动建模块。它只在已有 go.mod 的目录里操作依赖，否则就直接报错。
分清楚你要干啥：
- 想初始化一个新项目：先运行
go mod init example.com/myapp（模块名随便写，合法就行） - 只想装个命令行工具（比如
gopls、air）：加-d参数跳过构建，例如go install golang.org/x/tools/gopls@latest；或者显式指定安装位置：GOBIN=$HOME/bin go install golang.org/x/tools/gopls@latest - 误在
$GOPATH/src下执行了go get：Go 1.16+ 已弃用 GOPATH 模式，退出这个目录，换到任意空目录再试
注意：go get 在模块模式下默认会修改 go.mod 和 go.sum。如果只是临时 fetch 包不写依赖，用 go list -m -u all 或 go mod download 更安全。
GOROOT 设错导致 build 失败：它不该是你自己建的目录
GOROOT 只应指向 Go SDK 的安装根目录（比如 /usr/local/go 或 C:\Go），不是你放项目的目录，更不是 $HOME/go —— 后者是 GOPATH 的默认值，两者完全无关。
设错 GOROOT 的典型表现：
-
go build报类似import "fmt": cannot find package -
go env GOROOT输出和你实际安装路径不一致（比如显示/home/user/go）
排查方法：
- 运行
go env GOROOT看输出 - 搜所有 shell 配置文件（
~/.zshrc、~/.profile、~/.bashrc），删掉类似export GOROOT=$HOME/go的行 - 检查项目根目录有没有
.env或go.env文件偷偷覆盖了GOROOT
干净的做法是：完全不手动设置 GOROOT。只要 go 命令能正常运行，Go 工具链自己就能推导出正确的 GOROOT。
cgo 在 Windows 上报 gcc 缺失：禁用比装环境更务实
Windows 下 go build 如果涉及 cgo（比如用了 SQLite、某些图像库），默认会调用 gcc，但系统通常没有。错误信息一般是 exec: "gcc": executable file not found in %PATH%。
三种解法，按推荐顺序：
- 优先禁用 cgo：
CGO_ENABLED=0 go build。大多数纯 Go 项目不需要 cgo，禁用后生成静态二进制，部署更干净 - 装 MinGW-w64（轻量）：下载 MinGW-w64，把
bin目录加进Path，重启终端 - 用 WSL2（彻底）：适合长期做 Go 开发的用户，避免 Windows 底层兼容性问题，
cgo行为和 Linux 一致
注意：CGO_ENABLED=0 会影响部分依赖（如 net 包的 DNS 解析策略），若项目明确依赖 cgo 功能，不能无脑禁用 —— 但绝大多数 Web/API 服务可以安全关闭。
