go run 报错主因是 PATH 未包含 $GOROOT/bin（Linux/macOS）或 %GOROOT%\bin（Windows），而非代码或版本问题；需用 which go/where go 确认路径，重启终端并验证 echo $PATH 或环境变量是否生效。
Go 环境装好了不等于能正常编译运行——go run 报错、GOROOT 和 GOBIN 混用、模块初始化失败，才是新手真正卡住的地方。
为什么 go version 能显示但 go run main.go 提示 command not found
常见于 macOS 或 Linux 下通过 pkg 安装 Go 后未正确配置 PATH，或 Windows 用户把 Go 安装在非默认路径却没更新环境变量。
- 检查
which go（macOS/Linux）或where go（Windows）输出是否指向你安装的 Go 目录 - 确认
$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows）已加入PATH，而不是只加了$GOROOT - 重启终端或重新加载 shell 配置（如
source ~/.zshrc），echo $PATH里必须能看到bin目录
go mod init 失败：no module found or no module is active
这不是权限问题，而是当前目录不在 GOPATH 下且未启用模块模式——Go 1.16+ 默认启用，但某些旧 shell 环境或 IDE 可能缓存了旧配置。
- 先运行
go env -w GO111MODULE=on强制开启模块支持 - 确保项目根目录下没有残留的
vendor/或Gopkg.lock文件干扰判断 -
go mod init example.com/myapp中的域名不需要真实存在，但不能是纯数字或含下划线
Windows 上 go build 生成 exe 却在另一台机器报错：failed to load DLL
默认静态链接被破坏，通常是用了 cgo 且未禁用动态依赖。
立即学习“go语言免费学习笔记（深入）”；
- 添加构建标签：
CGO_ENABLED=0 go build -o app.exe（Linux/macOS）或set CGO_ENABLED=0 && go build -o app.exe（Windows cmd） - 若必须用 cgo（比如调用 Windows API），需确保目标机器装有对应版本的 Visual C++ 运行库
-
go env -w CGO_ENABLED=0可设为全局，但会禁用所有 cgo 包，慎用
Go 的环境变量之间有隐式优先级：GOROOT 决定工具链位置，GOPATH 影响 go get 行为，而 GOBIN 只控制 go install 输出——三者混用时，一个配置错，go list 就可能返回意外结果。
