Go环境问题根源在于环境变量与模块配置错位：PATH未正确添加Go二进制路径导致command not found；GOPATH未设或路径含空格/中文致包找不到；GO111MODULE未强制设为on且GOPROXY未配国内代理（如https://goproxy.cn,direct）则依赖拉取失败。
Go 环境装完却 go version 报错、go run 找不到包、go get 卡住或失败——这些问题几乎都出在环境变量和模块配置上，不是 Go 本身难，而是路径和开关没对齐。
PATH 没加对，go 命令根本找不到
Mac 和 Linux 默认不把 Go 的二进制目录加进 PATH，Windows 安装时勾选了 “Add Go to PATH” 也可能被系统策略屏蔽。结果就是终端里敲 go 直接报 command not found。
- Mac/Linux：确认 Go 安装路径（
/usr/local/go/bin或 Homebrew 装在/opt/homebrew/bin），往~/.zshrc或~/.bash_profile里加一行：export PATH=$PATH:/usr/local/go/bin - Windows：检查系统环境变量里的
PATH是否真包含C:\Go\bin（不是安装目录，是bin子目录）；别信安装向导“已添加”，手动打开“系统属性 → 高级 → 环境变量”再核一遍 - 验证方式：新开终端，运行
which go（Mac/Linux）或where go（Windows），输出必须是具体路径，不能为空
GOPATH 不设或设错，go mod tidy 仍报 missing package
Go 1.11+ 默认开启模块模式（GO111MODULE=on），但很多老项目、工具（比如 Battery Historian 2.0）仍依赖 GOPATH/src 目录结构。如果 GOPATH 没设，或者设了但没建 src 目录，go get 会静默失败或把代码下到错误位置。
- 设
GOPATH：推荐用export GOPATH=$HOME/go（Mac/Linux）或setx GOPATH "%USERPROFILE%\go"（Windows），然后手动创建$GOPATH/src - 别混用：如果项目根目录有
go.mod，就别管GOPATH；但若要go install工具（如gopls），且没开GOBIN，它默认装到$GOPATH/bin，所以GOPATH仍得存在 - 常见陷阱：
GOPATH路径含空格或中文（如C:\Program Files\Go或/Users/张三/go），会导致几乎所有 Go 命令异常退出
GO111MODULE 和 GOPROXY 没开，依赖拉不下来
国内直连 golang.org/x 或 google.golang.org 几乎必超时，而 GO111MODULE=auto 在非 GOPATH 下可能误判为 legacy 模式，跳过代理直接连国外源。
立即学习“go语言免费学习笔记（深入）”；
- 强制开启模块：
go env -w GO111MODULE=on（必须，尤其 Windows 上安装 MSI 后常默认 off） - 配国内代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示私有域名走直连，避免公司内网被代理劫持） - 验证是否生效：运行
go env | grep -E "(GO111MODULE|GOPROXY)"，输出应为on和你设的地址，不是https://proxy.golang.org - 注意：某些 IDE（如 VS Code）会读取自己的 Go 环境配置，需在设置里单独指定
go.toolsEnvVars，否则界面里go mod tidy仍走默认代理
多版本共存时 which go 指向错版本
Homebrew、官网 pkg、ASDF、GVM 多种方式装 Go，容易让 which go 返回旧版本路径，而 go version 显示新版本——说明 shell 缓存了旧路径，或不同 shell 配置文件改了不同版本。
- 查真实路径：
command -v go（比which更可靠） +ls -l $(command -v go)看软链指向 - 清理冲突：删掉
/usr/local/go（官网 pkg 默认路径），Homebrew 装的在/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），优先用 Homebrew 管理 - 临时切换：不用卸载，直接
export PATH="/opt/homebrew/bin:$PATH"（Mac）或set PATH=C:\tools\go\bin;%PATH%（Windows）可立即生效
最麻烦的不是某一步做错，而是几个配置项互相影响：PATH 错了，go 命令都启动不了；PATH 对了但 GO111MODULE=off，go get 就绕过代理；代理设对了但 GOPATH 路径非法，工具装进去也执行不了。调的时候建议每次只动一个变量，用 go env 和 which go 交叉验证，别堆在一起改。
