go version命令不识别的根本原因是GOROOT/bin未加入PATH环境变量，需根据系统确认Go安装路径并将其添加至PATH，再重载配置文件验证。
go version 命令不识别，PATH 没配对
最常见的情况是安装完 Go 后，go version 报 command not found 或 'go' is not recognized。这不是 Go 没装好，而是 PATH 里漏掉了 $GOROOT/bin。
检查方式很简单：
- Windows：运行
echo %PATH%，确认输出里有类似C:\Go\bin或C:\Program Files\Go\bin - macOS/Linux：运行
echo $PATH，确认包含/usr/local/go/bin（官方包默认路径）或你解压的go目录下的bin
容易踩的坑：
- Homebrew 安装的 Go，路径通常是
/opt/homebrew/bin（M1/M2）或/usr/local/bin（Intel），不是/usr/local/go/bin - 手动解压 tar.gz 后没改权限（Linux/macOS 下
sudo chown -R $USER:staff /usr/local/go更稳妥） - Zsh 用户改了
~/.bashrc却没刷新~/.zshrc，导致配置不生效
GOPATH 和 go mod 冲突导致依赖拉取失败
如果你在非 $GOPATH/src 目录下执行 go run 或 go build 却遇到 no required module provides package，大概率是模块模式和旧工作区逻辑打架。
立即学习“go语言免费学习笔记（深入）”；
Go 1.16+ 默认启用 modules，但部分老教程仍强调设置 GOPATH。实际只需：
- 不必手动设
GOPATH——go mod会自动在当前目录初始化go.mod - 若已有
go.mod，就别进$GOPATH/src目录再建项目，否则go工具可能降级到 GOPATH 模式 - 检查是否意外设置了
GO111MODULE=off：运行go env GO111MODULE，应为on
顺手验证：go mod init example.com/hello 能成功生成 go.mod，说明模块系统就绪。
macOS M1/M2 上 go build 报 architecture 不匹配
现象是 cannot execute binary file: Exec format error 或编译时提示 unsupported architecture，尤其在用 Homebrew 安装后又手动下载了 amd64 包混用时。
关键看 go version 输出末尾：
-
darwin/arm64→ 本机原生，放心用 -
darwin/amd64→ Rosetta 模拟，部分 cgo 依赖（如 SQLite、openssl）可能出问题
解决办法很直接：
- 卸载所有 Go 版本，只留一个：Homebrew 的
brew uninstall go，再删掉/usr/local/go - 从 https://go.dev/dl/ 下载明确标着
darwin-arm64的 pkg - 编译时加
GOARCH=arm64强制指定（虽然通常不需要）
go run 执行报错：package main is not a main package
这错误不是环境问题，而是文件结构不对。Go 要求可执行程序必须满足两个硬条件：
- 文件在
package main声明的包里 - 该包内定义了
func main()
典型误操作：
- 把
main.go放在子目录（如cmd/myapp/main.go）却在父目录运行go run main.go—— 正确做法是go run cmd/myapp/main.go或go run ./cmd/myapp - 复制粘贴代码时漏了
func main()大括号，或拼错成Func Main() - 文件名含空格或中文（比如
我的第一个go程序.go），某些 shell 下解析异常
最省事的验证方式：新建空目录，写入标准模板，立刻 go run main.go —— 成功了，说明环境没问题，问题出在原有项目结构上。
