GOROOT必须显式设置，否则go install会失败；需手动配置GOROOT和PATH，验证go env GOROOT；GOPATH建议设置为全英文无空格路径并加入PATH；GOBIN不推荐单独设置；GOPROXY和GOSUMDB须配置以解决国内依赖拉取问题。
GOROOT 必须显式设置，否则 go install 会失败
即使 MSI 安装器勾选了 “Add Go to PATH”，GOROOT 也未必被写入系统变量——尤其当你解压 ZIP 版（如 go1.23.1.windows-amd64.zip）到非默认路径（比如 D:\golang）时。go install 命令依赖 GOROOT 定位标准库和工具链，缺失会导致 go install gopls 等命令报错或静默失败。
手动配置方式：
- 新建系统环境变量：
GOROOT，值为 Go 解压/安装根目录（如D:\golang或C:\Program Files\Go） - 把
%GOROOT%\bin加入PATH（不是GOROOT本身） - 重启所有已打开的终端（cmd/PowerShell/IDE），再运行
go env GOROOT验证输出是否与你设置的一致
GOPATH 不是必须项，但 go install 默认往它里面扔二进制
Go 1.16+ 默认启用模块模式，GO111MODULE=on，GOPATH 对项目构建影响变小。但它仍控制 go install 输出位置：不设 GOPATH，go install 会尝试写入默认路径（如 C:\Users\YourName\go\bin），而该路径可能无写权限或被杀毒软件拦截。
建议做法：
立即学习“go语言免费学习笔记（深入）”；
- 新建系统变量：
GOPATH，值设为一个**全英文、无空格、有写权限**的路径（如D:\gopath） - 把
%GOPATH%\bin加入PATH（否则go install生成的命令在终端里找不到） - 运行
go env GOPATH和where gopls（Windows）确认路径生效且可访问
GOBIN 是个陷阱：设了它，GOPATH/bin 就被忽略
GOBIN 是个高优先级变量——只要它被设了（哪怕为空字符串），go install 就只往 GOBIN 写，完全跳过 %GOPATH%\bin。很多人设了 GOBIN 却没把它加进 PATH，结果命令装上了却找不到。
稳妥方案：
- **不要单独设
GOBIN**，除非你明确需要隔离安装路径 - 如果必须用，确保
GOBIN指向一个真实存在的目录，并且该路径已加入PATH - 检查是否意外设置了它：
go env GOBIN，若输出非空但路径不存在或不可写，就删掉这个变量
GOPROXY 和 GOSUMDB 必须配，否则依赖拉不下来
国内直连 proxy.golang.org 基本超时，不配 GOPROXY 会导致 go get、go mod download 卡住或失败。更隐蔽的是 GOSUMDB：用国内代理后，校验服务器（sum.golang.org）同样不可达，不关它就会报 checksum mismatch。
推荐命令一次性配齐：
go env -w GOPROXY=https://goproxy.cn,direct-
go env -w GOSUMDB=off（仅限内网或可信环境；生产环境建议用GOSUMDB=sum.golang.org+ 科学上网） - 验证：
go env GOPROXY GOSUMDB，输出应与你设置一致
注意：PowerShell 中执行 go env -w 后，需新开窗口才能生效；CMD 下同理。别在同一个终端里改完立刻 go mod download 测试，容易误判。
