go version报错是path未配置，非安装失败；gopath与modules混用致依赖混乱；代理失效需设goproxy+gosumdb；goland需手动设goroot；四环境变量耦合需用go env排查。
go version 命令报错或显示“command not found”
说明 go 二进制没进 PATH，不是安装失败，而是路径没生效。Windows 上常见于 MSI 安装后没重启命令行；macOS/Linux 则多因 shell 配置文件（如 ~/.zshrc）没重载。
- Windows：打开新 PowerShell 或 CMD，运行
echo %PATH%，确认C:\Go\bin或你自定义的安装路径下的bin目录已包含在内 - macOS（M1/M2）：Homebrew 安装后路径通常是
/opt/homebrew/bin，但go自身二进制实际在/opt/homebrew/opt/go/bin，需显式添加该路径到PATH - Linux：检查
/usr/local/go/bin是否写入~/.bashrc或~/.zshrc，改完记得执行source ~/.zshrc
GOPATH 和 Go Modules 混用导致依赖混乱
Go 1.11+ 默认启用模块（Modules），但若仍保留旧式 GOPATH/src 工作流，go get 可能写入 $GOPATH/src 而非 go.mod，造成本地代码和依赖路径不一致、CI 构建失败等现象。
- 新建项目务必先执行
go mod init example.com/myapp，生成go.mod文件后再写代码 - 不要手动创建
$GOPATH/src/xxx目录来放项目——模块模式下，项目可放在任意路径，只要含go.mod - 若遇到
go: modules disabled by GO111MODULE=off错误，运行go env -w GO111MODULE=on强制启用模块
代理设置失效导致 go get 卡住或 403
国内直接拉取 golang.org 或 google.golang.org 下的包几乎必超时或被拒，但仅设 GO_PROXY 不够，还需关掉校验或补全私有仓库规则。
- 推荐配置：
go env -w GOPROXY=https://proxy.golang.org,direct（官方代理 fallback 到 direct）或国内镜像：go env -w GOPROXY=https://goproxy.cn,direct - 若公司内网用私有仓库（如 Nexus），需加
GOINSECURE：例如go env -w GOINSECURE="my.internal.repo" - 某些包（如
cloud.google.com/go）会触发额外域名请求，仅配GOPROXY不够，建议同步设go env -w GOSUMDB=off（开发阶段临时关闭校验）
GoLand 启动时提示 “GOROOT not set” 或调试失败
IDE 不读系统环境变量，尤其在 macOS GUI 启动时，~/.zshrc 中的 GOROOT 完全不可见，导致插件、测试、调试全挂。
- GoLand 设置路径：
Preferences → Go → GOROOT，手动指定为/usr/local/go（macOS pkg）或/opt/homebrew/opt/go/libexec（Homebrew） - 不要依赖 “Auto-detect”，它常识别成
/usr/local/bin/go这种软链，而非真实GOROOT - 调试时若提示 “cannot find main.go”，检查
Run Configuration → Working directory是否指向含go.mod的根目录，而非子文件夹
go env 看一眼当前快照，比反复重装更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
