根本原因是PATH未正确配置，导致系统找不到go命令；需根据操作系统将Go的bin目录加入PATH，并验证which go或where go输出，再执行go version确认。
Go 安装后 go version 报错或找不到命令
根本原因通常是 PATH 没配对，尤其在 macOS 或 linux 下用包管理器（如 Homebrew）安装，或 windows 下手动解压后没改系统环境变量。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Windows：确认解压后的
bin目录（如C:gobin）已加入「系统环境变量」的PATH，不是用户变量；重启终端或 CMD/PowerShell 再试 - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否添加了export PATH=$PATH:/usr/local/go/bin（Homebrew 默认路径是/opt/homebrew/bin，但go本身仍装在/usr/local/go/bin）；执行source ~/.zshrc生效 - 验证方式：运行
which go（macos/Linux）或where go（Windows），必须有输出；再跑go version
GO111MODULE 默认行为在不同 Go 版本下不一致
Go 1.16+ 默认开启模块模式（GO111MODULE=on），但低于 1.16 的版本默认是 auto——即只有在 GOPATH 外才有模块行为。新手常因此遇到 go: cannot find main module 或依赖不下载问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 统一设为
GO111MODULE=on，避免路径依赖：运行go env -w GO111MODULE=on - 不要把项目放在
$GOPATH/src下再用模块——这是过时做法，容易触发auto模式下的歧义 - 新建项目直接在任意目录执行
go mod init myapp，别管 GOPATH - 如果已有老项目，删掉
vendor/和go.mod后重新go mod init，比硬调兼容模式更可靠
go get 不再自动写入 go.mod（Go 1.17+）
从 Go 1.17 开始，go get 默认只升级依赖，不再隐式添加新包到 go.mod，导致新手执行 go get github.com/sirupsen/logrus 后编译报 cannot find package。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 显式加
-u参数只是升级，要引入新包请用：go get github.com/sirupsen/logrus@latest（带版本）或go get github.com/sirupsen/logrus（Go 1.20+ 可接受无版本，但仍推荐带） - 更稳妥的方式是先 import 包，再运行
go mod tidy，它会自动下载、记录并清理未用依赖 - 避免混用
go get和go mod tidy：前者易漏写require，后者才是现代 Go 的依赖事实来源
GOROOT 和 GOPATH 容易被误设或冗余配置
GOROOT 是 Go 安装根目录，通常无需手动设置（安装程序或包管理器已写好）；GOPATH 在模块模式下仅影响 go install 生成的二进制存放位置（$GOPATH/bin），和代码组织无关。新手常因教程陈旧，反复设置这两个变量，反而引发冲突。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查当前值：
go env GOROOT和go env GOPATH；正常情况GOROOT应指向安装路径（如/usr/local/go），GOPATH默认是$HOME/go，不用改 - 除非你明确需要把
go install的命令装到别处，否则不要碰GOPATH；更不要把项目目录塞进$GOPATH/src - 如果曾手动设过
GOROOT，且现在go version报错，优先运行go env -u GOROOT清除，让 Go 自行推导
Go 环境最麻烦的从来不是装不上，而是多个配置项之间互相掩盖真实错误——比如 PATH 错了却去调 GOPATH，或者 GO111MODULE 关着却硬用 go mod 命令。动手前先跑一遍 go env，比查十篇博客更快定位问题。