go环境“能用”需满足五要素：二进制可调用、模块启用（go111module=on）、代理可用（goproxy设置正确）、工具链可安装、$gopath/bin在path中；仅go version通过不等于环境就绪。
go version 能跑，不代表环境能用
很多人看到 go version 输出就以为万事大吉，结果 go run 报 cannot find module、go install gopls@latest 成功但终端敲 gopls 提示 command not found、VS Code 一直显示 “Loading…”——这些都不是 Go 没装好，而是环境变量或模块配置没对齐。
真正“能用”的环境必须同时满足：二进制可调用、模块模式启用、代理可连、工具链可安装、$GOPATH/bin 在 PATH 中。
检查 go env 里这 4 个关键项
运行 go env，重点确认以下字段：
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
-
GOROOT：应指向真实安装路径（如/usr/local/go或~/sdk/go1.26.0），且需和which go输出一致；若为 Homebrew 管理路径，要确认它没被 shell 配置覆盖 -
GOPATH：Go 1.16+ 默认是$HOME/go，改过的话必须确保$GOPATH/bin已加入PATH（否则go install生成的命令无法全局调用） -
GO111MODULE：必须为on；旧系统可能残留auto或off，会导致go mod init不生效、依赖不下载 -
GOPROXY：国内用户建议设为https://goproxy.cn,direct；若为空或仍是https://proxy.golang.org，go get极大概率超时失败
用两行命令验证是否真打通
别只跑 go run main.go，得测工具链分发和依赖拉取能力：
- 新建目录，执行
go mod init testenv，确认生成go.mod - 写个带外部依赖的
main.go（比如import "golang.org/x/net/html"），再跑go run main.go—— 若报no required module provides package，说明GOPROXY没生效或网络不通 - 执行
go install golang.org/x/tools/cmd/godoc@latest，然后直接输入godoc—— 若提示command not found，说明$GOPATH/bin没进PATH，或GOPATH和go env GOPATH输出不一致
IDE 启动失败？先绕过 IDE 直接验 gopls
VS Code 或 GoLand 报 “Failed to start gopls” 或 “No definition found”，大概率不是插件问题：
- 手动运行
gopls version：若报command not found，说明没装或没进PATH - 若卡住几秒后报
timeout，优先查GOPROXY是否可用、GOROOT是否指向错误路径（比如指向了旧版本解压目录但实际go命令来自 Homebrew） - JetBrains 系列 IDE 不自动继承 shell 环境变量，需在 Settings → Go → GOROOT 点击 “Reload” 或重启 IDE 才刷新配置
最容易被忽略的是：go install 生成的命令是否真能从任意路径调用。很多人的 PATH 里漏了 $GOPATH/bin，或者 shell 配置文件（~/.zshrc vs ~/.bashrc）没选对，导致终端里能跑、IDE 里就断联。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
