Go环境搭建核心是确保go命令稳定调用、模块正常初始化、编辑器正确加载项目；需重点解决PATH未生效、GO111MODULE未启用、GOPROXY未配国内源三大问题，而非堆砌环境变量。
Go 环境搭建不是“配一堆变量就完事”，而是围绕 go 命令能否稳定调用、模块能否正常初始化、编辑器能否正确加载项目这三件事展开。其他所有配置，都是为这三点服务的。装完就 go version 成功，不等于环境真可用；go mod init 报错或 gopls 启动失败，大概率是多个配置项互相干扰导致的。
PATH 没生效是最常见的“假成功”
很多人执行 go version 看到输出就以为装好了，但新开终端后命令就失效，或者 VS Code 里 gopls 找不到 go。本质是 shell 的 PATH 没真正加载。
- macOS / Linux：运行
which go，没输出说明 PATH 没生效；检查安装路径（如/usr/local/go/bin）是否写进了~/.zshrc或~/.bash_profile，且执行过source ~/.zshrc - Windows：在 PowerShell 里运行
Get-Command go，失败则去「系统属性 → 高级 → 环境变量」确认C:\Program Files\Go\bin（或你自定义的GOROOT下的bin）已加入用户或系统 PATH - 别信安装器勾选的“添加到 PATH”——它只对当前会话生效，重启终端或重新打开 VS Code 才能体现
GO111MODULE 和 vendor/ 是模块初始化失败的主因
go mod init 静默失败、生成空 go.mod、或推导出奇怪的 module 名（比如 src/github.com/xxx），几乎都卡在这两个点上。
- 强制启用模块：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但 CI 脚本或旧终端可能残留off） - 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor 模式） - 确保当前目录不在
$GOPATH/src下——如果在，go mod init会按旧 GOPATH 规则推导 module 名，极易出错；建议直接在~/projects/myapp这类任意非 GOPATH 路径下新建项目
GOPROXY 不设国内源，go get 和 gopls 就会卡住
默认代理 https://proxy.golang.org,direct 在国内基本不可用，会导致依赖下载超时、工具安装失败（如 gopls、dlv）、VS Code 插件反复报错。
立即学习“go语言免费学习笔记（深入）”；
- 设阿里云镜像：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 设 goproxy.cn：
go env -w GOPROXY=https://goproxy.cn,direct - 设置后验证：
go env GOPROXY应输出你刚设的地址；再试go list -m all，不卡顿即生效
VS Code 中 gopls 启动失败，90% 是项目结构或权限问题
gopls 不是插件装上就行，它依赖 go 可用、项目有合法 go.mod、且文件在支持的路径下。
- 确保项目根目录存在
go.mod（由go mod init生成），且不是空文件 - 确保打开的是整个项目文件夹（不是某个子目录），VS Code 左下角状态栏应显示 “Go (GOPATH)” 或 “Go (Module)”
- 确保
.go文件在项目根目录或其子目录下，不在$HOME或桌面等“裸路径” - Linux/macOS 下若提示 permission denied，检查
go和gopls是否被 SELinux 或 sandbox 限制（少见但存在）
真正稳定的 Go 环境，不是靠堆参数，而是靠删干扰项：清掉 vendor/、避开 $GOPATH/src、关掉旧模式、换掉默认代理。这些动作比反复改 GOPATH 或 GOROOT 有效得多。
