Go环境搭建关键在三件事：路径不冲突、模块代理可用、工具链能自动补全；需正确配置GOPROXY（如https://goproxy.cn,direct）、GOBIN与PATH，确保GOROOT准确，且每次升级Go版本后重装gopls等工具。
Go 环境搭建不是“装完 go 就能写代码”，关键在三件事：路径不冲突、模块代理可用、工具链能自动补全。其他步骤都是围绕这三点展开的。
go version 能跑，但 go mod init 报错：多半是 GOPROXY 没设对
国内直接用官方默认代理 https://proxy.golang.org 会卡住或超时，go mod download 失败、go get 无响应、VS Code 提示 “no packages found” 都是典型表现。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且同步及时） - 备选可换
https://mirrors.aliyun.com/goproxy/或https://mirrors.cloud.tencent.com/go/ - 验证是否生效：
go env GOPROXY应输出你刚设置的地址，不是https://proxy.golang.org,direct - 如果公司内网有私有代理，需把
direct放最后，否则内部模块无法拉取
Windows 下 go install 失败：PATH 和 GOBIN 容易互相干扰
go install 生成的二进制（如 gopls、dlv）默认放进 $GOBIN，但 VS Code 或终端找不到它，常因 GOBIN 没加进系统 PATH，或和 GOROOT/bin 冲突。
- 不要手动改注册表或系统环境变量里的
Path—— 用 PowerShell 运行：[Environment]::SetEnvironmentVariable("GOBIN", "$env:USERPROFILE\go\bin", "User") - 再追加：
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:GOBIN", "User") - 重启终端，运行
echo $env:GOBIN和echo $env:Path确认包含 - 避免同时设
GOPATH和GOBIN到不同盘符（比如GOPATH在 D:\，GOBIN在 C:\），Windows 下偶尔触发权限或符号链接问题
Linux/macOS 上 go env 显示 GOROOT 错误：解压位置和环境变量不匹配
常见于手动解压 tar.gz 后没清旧目录，或 GOROOT 指向了子目录（如 /usr/local/go/go），导致 go 命令找不到自身 runtime。
立即学习“go语言免费学习笔记（深入）”；
- 确认解压目标是
/usr/local/go（不是/usr/local/go/go）：ls /usr/local/go/bin/go必须存在 -
GOROOT必须严格等于解压路径：go env -w GOROOT=/usr/local/go - 如果用
brew install go，GOROOT通常是/opt/homebrew/opt/go/libexec（Apple Silicon）或/usr/local/opt/go/libexec（Intel），go env GOROOT会告诉你真实值 - 别在
~/.bashrc里重复 exportGOROOT——go自带逻辑能自动推导，硬写反而容易出错
VS Code Go 扩展提示 “Failed to start language server”：gopls 没装或版本不兼容
不是所有 go install 命令都适用最新 gopls；Go 1.23+ 默认要求 gopls v0.14+，旧版会静默失败。
- 先删旧版：
go clean -cache -modcache，再删$GOBIN/gopls - 装指定版本：
go install golang.org/x/tools/gopls@v0.14.4（对应 Go 1.23.x） - VS Code 设置里关掉
go.useLanguageServer再开一次，强制重连 - 如果项目含
go.work文件，确保gopls版本支持 workspace 模式（v0.13.5+）
最常被跳过的一步：每次换 Go 版本后，go install 的工具必须重装，gopls 和 dlv 尤其敏感 —— 它们不是“一次安装终身可用”。
