90%的Go环境问题源于GOROOT、GOPATH与PATH路径未对齐，或GO111MODULE/GOPROXY配置错误；需验证go env输出与手动设置一致，并确保PATH包含$GOROOT/bin和$GOPATH/bin，Windows用cmd验证更可靠。
Go 环境配不起来，90% 的问题出在 GOROOT、GOPATH 和 PATH 三者路径没对齐，或者 GO111MODULE 和 GOPROXY 没关/没设对。别急着重装，先检查这几处。
go version 能跑但 go env 报错或路径不对
这是最典型的环境变量错位。Windows 用户尤其容易把 GOROOT 设成安装包解压目录（比如 C:\go），却忘了在 PATH 中加 %GOROOT%\bin；Linux/macOS 用户常漏掉 export 或写错 shell 配置文件（.zshrc vs .bashrc）。
- 运行
go env GOROOT和go env GOPATH，确认输出路径和你手动设置的一致 - 检查
PATH是否包含$GOROOT/bin和$GOPATH/bin（Windows 是%GOROOT%\bin和%GOPATH%\bin） - Windows 上建议用
cmd而非 PowerShell 验证，避免 shell 初始化差异干扰
go get 失败：timeout 或 “no required module provides package”
Go 1.16+ 默认启用模块模式，但国内直连 proxy.golang.org 基本失败。这不是网络问题，是代理没切过去。
- 执行
go env -w GO111MODULE=on强制开启模块管理 - 必须设镜像源：
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy - 若项目已有
go.mod且报包找不到，先删掉它再go mod init xxx，避免旧缓存干扰
Windows 下编译 GUI（如 Fyne）提示 “exec: 'gcc': executable file not found in %PATH%”
Fyne、Systray 等依赖 CGO 的库，需要本地 C 编译器。Windows 默认没有，也不能只靠 go install 解决。
立即学习“go语言免费学习笔记（深入）”；
- 装 TDM-GCC（不是 MinGW-w64，兼容性更稳），安装时勾选 “Add to PATH”
- 装完后重启终端，运行
gcc --version确认能识别 - 临时禁用 CGO 可绕过（
CGO_ENABLED=0 go build），但 GUI 应用会直接失败，不建议
Mac 上 go run 正常但 go build 失败，提示 “xcrun: error: unable to find utility ‘xcodebuild’”
这是 Xcode 命令行工具缺失，和 Go 本身无关，但影响所有依赖系统 SDK 的构建（包括 net/http、os/user 等标准库）。
- 运行
xcode-select --install安装命令行工具（不用装完整 Xcode） - 如果已装但失效，执行
xcode-select --reset - 验证：
xcode-select -p应输出类似/Applications/Xcode.app/Contents/Developer
真正卡住的点往往不是“不会装”，而是某一行 go env -w 没生效、某个终端没重开、某个路径多了一个空格——这些细节比版本选择重要得多。
