Go环境配置关键在GOROOT、GO111MODULE和GOPROXY：GOROOT须指向Go根目录（不含/bin），GO111MODULE必须为on，GOPROXY需设为https://goproxy.cn,direct，否则go get卡住、IDE找不到工具、go run报错找不到包。
Go 环境现在基本不用手动配 GOPATH，但 GOROOT 和模块代理仍得确认，否则 go get 会卡住、IDE 找不到工具、go run 报错找不到包。
go version 能跑 ≠ 环境就 ready
很多用户执行 go version 成功后就以为万事大吉，结果一写 main.go 就报 cannot find package "fmt" 或 go: cannot find main module。根本原因不是 Go 没装好，而是：
• GOROOT 被其他旧版本残留覆盖（尤其 Windows 多次重装后）
• shell 启动时没加载最新 PATH（macOS zsh / Linux bashrc 改了但没 source）
• go env -w 写错了值，比如把 GOROOT 设成 /usr/local/go/bin（多了 /bin）
验证方式不是只看 go version，而是运行：
go env GOROOT GOPATH GOMODCACHE GO111MODULE
其中：
• GOROOT 应指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），**不能带 /bin**
• GO111MODULE 必须是 on（1.16+ 默认开启，但某些旧终端会 fallback 到 auto）
• GOMODCACHE 路径要可写，否则 go get 下载依赖失败
立即学习“go语言免费学习笔记（深入）”；
Windows 上 PATH 配错最常见三处
Windows 用户最容易在“系统属性 → 环境变量”里配错，尤其当安装路径不是默认时：
-
GOROOT变量值填成了C:\Go\bin（正确应为C:\Go） -
Path里重复添加了%GOROOT%\bin和C:\Go\bin，导致冲突 - 用 PowerShell 测试却没重启它——改完环境变量后，旧 PowerShell 实例不会自动刷新
$env:PATH
建议操作：
• 全部删掉自定义 GOROOT 和 GOPATH 变量，让 Go 自动推导（新版足够可靠）
• 只确保 Path 包含 %GOROOT%\bin（注意是变量引用，不是硬编码路径）
• 改完后关掉所有终端，新开一个 cmd 再测 go env GOROOT
go mod init 后 go get 一直卡在 “Fetching”
这是国内用户最常遇到的阻塞点，本质是模块代理没生效，不是网络问题。默认 https://proxy.golang.org 在大陆无法直连。
必须显式设置代理（Go 1.13+ 支持）：
go env -w GOPROXY=https://goproxy.cn,direct
注意：
• 不要用 https://goproxy.io（已停服）
• direct 必须保留，否则私有仓库地址会失败
• 如果公司内网有自建代理，把它加在 direct 前面，例如：https://intranet-goproxy.example.com,https://goproxy.cn,direct
• 设置后无需重启终端，但已有 go mod download 进程需中断重试
VSCode 插件提示 “Failed to find tools”
vscode-go 插件启动时会尝试调用 gopls、goimports 等二进制工具。如果这些工具没装或路径不对，编辑器就无法补全、跳转、格式化。
解决方法不是重装插件，而是执行：
go install golang.org/x/tools/gopls@latest
再检查插件设置中：
• go.toolsGopath 留空（新版插件已弃用该配置）
• go.goroot 应和 go env GOROOT 一致
• 关键：确保 go env GOPATH 下的 bin 目录在系统 PATH 中（插件靠 PATH 找 gopls）
如果仍失败，临时在 VSCode 终端里运行 gopls version —— 报 command not found 就说明 go install 没生效，重点查 GOPATH/bin 是否进了 PATH。
