Go 1.24.x在Windows上仅go version成功不代表环境就绪；必须正确配置GOROOT（安装路径）、GOPATH（可选但需避免与GOROOT冲突）、GOPROXY（如https://goproxy.cn,direct），并确保go mod启用，否则构建或依赖下载会失败。
Go 1.24.x 在 Windows 上安装后，go 命令能直接运行，不代表环境配置已就绪；多数人卡在 GOPATH 和 GOROOT 冲突、go mod 与旧工作区混用、代理失效这三处。
go version 能跑 ≠ GOPATH 就位
MSI 安装器默认勾选“Add Go to PATH”，所以 go version 成功只是说明 %GOROOT%\bin 已进系统 PATH —— 这只够运行命令，不等于项目能正常构建或依赖能下载。
-
GOROOT应指向 Go 安装根目录（如C:\Go或D:\golang），必须与实际安装路径完全一致；若手动改过安装路径却没同步更新GOROOT，go env GOROOT会输出错误路径 -
GOPATH不再强制要求（Go 1.16+ 默认启用 module 模式），但若你仍用go get传统方式拉包，或某些老工具（如gocode）依赖它，则必须显式设置，且不能和GOROOT相同 - 常见错误：
go build报cannot find module for path，往往是因为当前目录不在 module 根下，且GOPATH又没设对，导致 go 误判为 legacy 模式
go env 显示的 GOPATH 是假象
执行 go env GOPATH 返回 C:\Users\xxx\go，不代表这个路径被真正用于存放代码或 bin 文件 —— Go 1.16 后，go env 默认回退到用户主目录下的 go 子目录，但只要你没主动 go mod init 或没在 GOPATH\src 下建项目，它基本不参与构建流程。
- 真正起作用的是：当前目录是否存在
go.mod；存在则走 module 模式，GOPATH被忽略 - 若你坚持用
GOPATH工作流（比如把项目放在%GOPATH%\src\github.com\user\repo），必须确保该路径下有合法的 import 路径，且go install生成的二进制会落在%GOPATH%\bin，而非当前目录 - Windows 上常见陷阱：PowerShell 中用
$env:GOPATH查看变量值，但 CMD 里要用%GOPATH%；混用终端类型会导致配置“看似生效实则失效”
GOPROXY 必须设，否则 go get 直接卡死
默认 GOPROXY 是 https://proxy.golang.org,direct，国内访问 proxy.golang.org 多数情况超时或 403，go get 或 go mod download 会 hang 住 30 秒以上才 fallback 到 direct，而 direct 拉 golang.org/x/... 等包又大概率失败。
立即学习“go语言免费学习笔记（深入）”；
- 推荐设为：
https://goproxy.cn,direct或https://mirrors.aliyun.com/goproxy/,direct - 设置命令（CMD）：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY输出应与设置一致；再试go mod download golang.org/x/net，几秒内完成即 OK - 注意：如果公司内网有私有模块（如
git.internal.company.com/lib），需额外加GOPRIVATE=git.internal.company.com，否则 proxy 会尝试转发私有地址导致 404
GOROOT 和 GOPATH 别放同一盘符根目录
不是技术限制，而是实操雷区：C 盘空间紧张时，GOCACHE（默认在 %LocalAppData%\go-build）和 %GOPATH%\pkg 编译缓存会快速吃掉数十 GB，而 C 盘一旦满，Windows 更新、Visual Studio Code、甚至 go tool 都可能异常退出。
- 建议组合：
GOROOT保留在C:\Go（MSI 默认，方便多版本切换）；GOPATH改到D:\mygo；GOCACHE单独设为E:\go-cache - 设置
GOCACHE后，首次go build可能稍慢（要重建缓存索引），但后续增量编译速度明显提升 - 别用 OneDrive 或 iCloud 同步
GOPATH或GOCACHE目录——文件锁和实时同步冲突会导致go build报permission denied或invalid operation
