go version能运行不代表环境完整，还需验证goroot、gopath、go111module、goproxy四项配置，并确保$gopath/bin在path中、模块代理可用、go install生成的命令可全局调用。
go version 能跑，不代表环境完整
很多人执行 go version 看到输出就以为装好了，但实际写项目时会卡在 go run 找不到包、go install 命令不生效、IDE 提示 “no Go files in workspace” —— 这些都不是 Go 本身没装好，而是环境变量或模块配置没对齐。
真正完整的环境必须同时满足：二进制可用、模块模式启用、代理可连、工具链可安装、$GOPATH/bin 在 PATH 中（用于 go install 生成的命令）。
检查 go env 输出里这 4 个关键项
运行 go env，重点看以下字段是否符合预期：
-
GOROOT：应指向你解压 Go 的真实路径（如/usr/local/go），不能是空或错误路径；若为$HOME/sdk/go1.22.3这类 Homebrew 管理路径，要确认它和which go输出一致 -
GOPATH：Go 1.16+ 默认是$HOME/go，改过的话需确保$GOPATH/bin已加入PATH（否则go install golang.org/x/tools/gopls@latest安装后无法全局调用） -
GO111MODULE：必须为on；旧系统可能残留auto或off，导致go mod init不生效 -
GOPROXY：国内用户建议设为https://goproxy.cn,direct或https://repo.yyrd.com/artifactory/aliyun-golang/,direct；若为空或https://proxy.golang.org，go get很可能超时失败
验证 go install 和 go run 是否真正打通
仅跑通 go run main.go 不够，还得验证工具链和可执行文件分发能力：
- 新建测试目录，执行
go mod init testenv，确认生成go.mod文件 - 写一个带依赖的
main.go（例如 import"golang.org/x/net/html"），再运行go run main.go—— 若报错cannot find module，说明GOPROXY没生效或网络不通 - 运行
go install golang.org/x/tools/cmd/godoc@latest（或gopls），然后直接在终端输入godoc—— 若提示 command not found，说明$GOPATH/bin没进PATH，或者GOPATH和go env GOPATH输出不一致
IDE 启动失败？先查 gopls 是否真能跑
VS Code 或 GoLand 报 “Failed to start gopls” 或 “No definition found”，往往不是插件问题，而是 gopls 本身启动失败：
- 手动运行
gopls version，如果报 command not found，说明没装或没进 PATH；如果卡住几秒后报 timeout，大概率是GOPROXY不可用或GOROOT指向错误 -
gopls依赖当前目录下有 validgo.mod；在空白目录运行会失败，必须先进入一个已go mod init的项目根目录再试 - 某些 IDE（如老版 GoLand）会读取系统 shell 的环境变量，但 GUI 启动方式可能不加载
~/.zshrc；macOS 用户可尝试从终端执行open -a GoLand启动，确保环境变量继承正确
最常被忽略的点：PATH 里混了多个 Go 版本路径，go 命令和 gopls 实际来自不同安装源；只要 which go 和 which gopls 输出路径不一致，就一定出问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
