Go环境真正可用需验证四点：go env输出（GOROOT、GOPATH、GOMODCACHE、GO111MODULE）、GOPROXY是否生效（如goproxy.cn,direct）、VSCode是否继承PATH（终端执行which go确认）、GOBIN是否加入PATH且可写。
go 命令能跑起来，不代表 Go 环境就真正可用；很多问题在 go run 时才暴露，比如模块下载失败、代理没生效、GOPATH 和 GOBIN 冲突。别急着写代码，先确认这四件事。
验证 go env 输出是否合理
只运行 go version 是不够的——它只检查二进制是否存在。真正关键的是 go env 的输出，尤其注意这几个字段：
-
GOROOT：应指向你安装 Go 的根目录（Windows 默认是C:\Go，macOS/Linux 通常是/usr/local/go），不要手动改它，新版安装器已自动设置 -
GOPATH：Go 1.16+ 默认启用 modules，GOPATH不再影响依赖存放位置，但仍是go install安装可执行文件的默认目标（即$GOPATH/bin） -
GOMODCACHE：模块缓存路径，默认在$GOPATH/pkg/mod，如果磁盘空间小或想统一管理，建议用go env -w GOMODCACHE=/path/to/modcache显式设置 -
GO111MODULE：应为on（推荐），避免老式GOPATH模式干扰新项目
执行 go env 后，若发现 GOPATH 是空值或指向系统盘根目录（如 C:\），说明环境变量没生效或被覆盖，需检查 shell 配置文件（~/.zshrc、~/.bash_profile 或 Windows 的系统变量）里有没有重复的 export GOPATH=...。
go mod download 卡住？先看 go env GOPROXY
国内用户最常遇到的不是安装失败，而是 go get 或 go mod download 超时或 404——根本原因是模块代理没配。官方 proxy https://proxy.golang.org 在多数地区不可达。
推荐设置国内可信代理：
立即学习“go语言免费学习笔记（深入）”；
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（direct表示对私有域名直连，避免公司内网模块被代理拦截） - 验证：新建空目录，执行
go mod init test→go get github.com/sirupsen/logrus@v1.9.0，观察是否秒级完成 - 如果仍失败，检查是否被企业防火墙拦截——可临时换为
https://goproxy.io或自建athens
注意：GOPROXY 设置后，go list -m -f '{{.Dir}}' github.com/sirupsen/logrus 返回的路径会落在 $GOMODCACHE 下，而不是 $GOPATH/src，这是 modules 模式下的正常行为。
VSCode 插件报 “Go command not found”？查 PATH 和 shell 启动方式
即使终端里 go version 正常，VSCode 也可能找不到 go，典型现象是右下角提示 “Go command not found”，或按 Ctrl+Shift+P → “Go: Install/Update Tools” 报错。
原因通常是 VSCode 没继承你 shell 的 PATH：
- macOS：如果用 Terminal.app 启动 VSCode（
code .），PATH通常正确；但如果从 Dock 或 Spotlight 启动，它走的是 GUI session，读取的是~/.zprofile而非~/.zshrc，把export PATH=$PATH:/usr/local/go/bin移到~/.zprofile更稳妥 - Windows：确保在“系统属性 → 环境变量”中修改的是“系统变量”里的
Path，而非仅当前用户的；重启 VSCode（不是 Reload Window） - Linux：检查桌面环境启动方式，GNOME/KDE 可能不加载
~/.bashrc，改用~/.profile
验证方法：VSCode 中打开集成终端（Ctrl+`），直接输入 which go 或 go version —— 这个终端的行为，就是插件实际依赖的环境。
go install 生成的二进制找不到？盯紧 GOBIN
执行 go install golang.org/x/tools/gopls@latest 后，以为装好了，结果命令行敲 gopls 报 “command not found” ——大概率是 GOBIN 没加进 PATH，或者 GOBIN 本身没设。
GOBIN 默认等于 $GOPATH/bin，但它不会自动加入系统 PATH。解决步骤：
- 运行
go env GOBIN看输出路径（如/home/user/go/bin） - 把这个路径加进 shell 的
PATH（例如在~/.zshrc末尾加export PATH=$PATH:$(go env GOBIN)） - 重新加载配置，再执行
source ~/.zshrc，然后验证which gopls - 如果不想改全局
PATH，也可直接用绝对路径调用：$(go env GOBIN)/gopls version
容易忽略的一点：GOBIN 和 GOPATH 必须在同一个用户上下文里生效；如果你用 sudo go install，二进制会落到 root 的 GOBIN，普通用户自然找不到。
go env，比反复重装更省时间。 
