结论是：Windows/macOS/Linux三平台安装Go后，go env -w GOPROXY=https://goproxy.cn,direct是2026年最稳定国内镜像配置，但必须同步设置GO111MODULE=on和GOSUMDB=sum.golang.org，且需重启终端或执行source使环境变量生效，否则易出现校验失败或代理不生效问题。
直接上结论：Windows/macOS/Linux 三平台安装 Go 后，go env -w GOPROXY=https://goproxy.cn,direct 是当前（2026 年）最稳定、兼容性最好的国内镜像配置方式，但必须配合 GO111MODULE=on 和 GOSUMDB=sum.golang.org 才能完整生效。
安装后必须重启终端才能读取环境变量
所有平台（包括 Windows 的 CMD/PowerShell、macOS/Linux 的 Terminal）在安装 .msi/.pkg/.tar.gz 后，Go 的 GOROOT 和 PATH 都是通过系统级环境变量注入的。但已有终端进程不会自动 reload 这些变量。
- Windows：关闭所有 CMD/PowerShell 窗口，再重新打开；任务管理器里确认没有残留的
cmd.exe或powershell.exe进程 - macOS/Linux：执行
source ~/.zshrc（或~/.bash_profile）仅对当前 shell 生效；新开 Terminal 窗口更可靠 - VSCode：如果已打开，需完全退出再重开，否则内置终端仍用旧环境
go env -w 设置代理的三个关键参数缺一不可
只设 GOPROXY 常见报错：verifying github.com/some/pkg@v1.2.3: checksum mismatch 或 failed to verify module。这是因为校验数据库（GOSUMDB）默认仍走境外地址。
-
go env -w GO111MODULE=on：强制启用模块模式，避免go get误入 GOPATH 模式（新版 Go 默认开启，但某些旧 shell 可能缓存旧值） -
go env -w GOPROXY=https://goproxy.cn,direct：主代理用七牛云镜像，direct表示 fallback 到官方源（非强制走代理），适配私有模块 -
go env -w GOSUMDB=sum.golang.org：这是官方推荐值；若改用sum.golang.google.cn（中科大镜像）可能因证书问题失败，2026 年实测稳定性不如原值
验证代理是否真正生效的命令不是 go env | grep GOPROXY
go env | grep GOPROXY 只显示变量值，不反映实际网络行为。真正验证要触发一次真实依赖拉取：
立即学习“go语言免费学习笔记（深入）”；
- 新建空目录，执行
go mod init testproxy - 执行
go get github.com/go-sql-driver/mysql@v1.11.0 - 观察输出：成功时会显示
Fetching github.com/go-sql-driver/mysql@v1.11.0，且耗时通常 github.com/golang/net 就说明代理未生效 - 若失败，加
-v参数看详细日志：go get -v github.com/go-sql-driver/mysql，重点查Fetching行是否命中goproxy.cn
不同安装方式对 GOPATH 的影响容易被忽略
新版 Go（1.16+）默认启用 Modules，GOPATH 不再参与依赖管理，但仍有两个隐含作用：存放 go install 编译的二进制工具（如 gopls）、以及 go build 时的默认缓存路径（$GOPATH/pkg）。
- .msi/.pkg 安装：自动设
GOPATH=$HOME/go（Windows 是%USERPROFILE%\go），无需手动干预 - 手动解压 tar.gz：必须显式设置
GOPATH，否则go install工具会失败，报错cannot find module providing package - VSCode 插件提示 “No Go tools installed”：大概率是
GOPATH/bin不在PATH中，检查echo $PATH是否包含该路径
