go安装路径必须是c:\go，gopath须为英文无空格路径且非系统盘根目录，goroot和gopath需严格验证，gobin应显式设为%gopath%\bin以防权限失败。

Go安装路径必须是C:\Go，别用Program Files

Windows下Go的安装路径不是“选出来的”，而是“必须定死的”。C:\Go是唯一推荐路径，不是因为它多高级，而是因为几乎所有Go工具链（包括go build、go mod、交叉编译脚本）都默认硬编码了这个路径。一旦你选了C:\Program Files\Go，哪怕只多一个空格，就可能触发以下问题：

• go run main.go报cannot find package "fmt"——实际是runtime包加载失败，根源是路径空格导致GOROOT解析中断
• go env -w GOPROXY=...静默失效，后续go get仍走代理失败
• 某些CI/CD工具（如GitHub Actions中的actions/setup-go）会跳过校验直接挂载C:\Go，旧路径导致环境不一致

GOPATH不能含中文或系统盘根目录

GOPATH是你写代码、存依赖、放二进制的地方，不是安装目录。它必须满足三个硬条件：英文、无空格、有完整写权限。常见错误配置包括：

• GOPATH=C:\Users\张三\go → 中文用户名会导致go list输出乱码、go mod download卡在UTF-8校验
• GOPATH=C:\go → 系统盘根目录受UAC限制，go install写bin目录时直接permission denied
• GOPATH=D:\workspace\go → 合理，但需确认该路径已手动创建且当前用户有读写权（右键属性→安全→编辑权限）

验证GOROOT和GOPATH是否真生效

哪怕安装时勾选了“Add Go to PATH”，也得手动验证三个变量是否真正落地。关键不是“有没有”，而是“对不对”：

Golang Samber Hot

在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。

下载

• 新开一个cmd（不是旧终端），运行go env GOROOT → 必须输出C:\Go，不能是C:\Go\（末尾斜杠）或c:\go（大小写混用）
• 运行go env GOPATH → 输出必须是你设定的完整路径，比如C:\Users\YourName\go，不能是%USERPROFILE%\go（未展开）
• 运行echo %PATH% → 必须同时看到C:\Go\bin和C:\Users\YourName\go\bin（后者不能带%符号）

GOBIN没设时go install会往GOROOT写，导致权限失败

这是最隐蔽的坑：go install默认把编译出的可执行文件放进$GOPATH/bin，但如果GOBIN没显式设置，而GOPATH又配错了（比如为空或指向C:\Go），它就会退化到往$GOROOT/bin写——而C:\Go\bin是只读的，结果就是permission denied。

解决办法很简单：

• 运行go env -w GOBIN=%GOPATH%\bin（Windows）或go env -w GOBIN=$GOPATH/bin（macOS/Linux）
• 再执行go env GOBIN确认输出是真实路径，不是%GOPATH%残留
• 之后go install生成的二进制一定落在你可控的bin目录下

路径问题从来不是“装上就行”的事，GOROOT错一点，整个工具链就可能在某个构建环节突然哑火——尤其当你开始用go generate或集成第三方linter时，那些看似无关的路径细节会立刻反噬。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！