根本原因是path未配置，导致shell找不到go二进制文件；需将/usr/local/go/bin（mac/linux）或c:\go\bin（windows）加入path并source或重启终端。
Go 安装后 go version 报错：command not found
根本原因是系统找不到 go 二进制文件，不是安装失败，而是 PATH 没配对。
Mac/Linux 用户如果用官方 .pkg 或 tar.gz 安装，默认会把 go 放在 /usr/local/go/bin；Windows 则是 C:\Go\bin。但 shell 不会自动把这个路径加进 $PATH。
- 检查是否真有该路径：
ls /usr/local/go/bin/go（Mac/Linux）或dir C:\Go\bin\go.exe（Windows） - 临时验证：运行
/usr/local/go/bin/go version，能出结果就说明二进制本身没问题 - 永久生效：在
~/.zshrc（macOS Catalina+）或~/.bashrc末尾加一行export PATH="/usr/local/go/bin:$PATH"，然后source ~/.zshrc - 别漏掉
$PATH原有值——写成export PATH="/usr/local/go/bin"会清空整个 PATH，后续连ls都用不了
用 go install 装工具却提示 cannot find module providing package
这是 Go 1.16+ 默认关闭了 GOPATH 模式后最常踩的坑：你没在模块上下文里执行命令。
go install 现在要求目标包必须可解析为一个模块路径（比如 golang.org/x/tools/cmd/gopls@latest），而不是本地路径或裸包名。
- 错误示范：
go install gopls→ 找不到模块提供者 - 正确写法：
go install golang.org/x/tools/cmd/gopls@latest - 想装自己写的命令？先确保项目根目录有
go.mod，且main.go在模块声明的路径下，再用完整模块路径 + 版本号安装，例如：go install mydomain.com/mytool@v0.1.0 - 不指定版本号（如省略
@latest）时，Go 会尝试读当前目录的go.mod，若不存在就报错
设置 GOPROXY 后 go get 仍超时或 404
代理地址本身没错，但常见干扰来自环境变量覆盖、协议写错、或公司网络策略拦截。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
国内常用代理如 https://goproxy.cn 或 https://proxy.golang.org，但注意：
- 必须带
https://前缀，写成goproxy.cn会被当成模块路径而非代理地址 - 检查是否被其他配置覆盖：
go env -w GOPROXY=direct会强制关掉代理，用go env GOPROXY确认当前值 - 某些企业内网会拦截
proxy.golang.org的证书或域名，换成https://goproxy.cn更稳；如果连goproxy.cn都不通，试试加,direct回退机制：go env -w GOPROXY="https://goproxy.cn,direct" -
GO111MODULE=on必须启用，否则go get不走代理逻辑
VS Code 里 Go 扩展报 Failed to run tool: go list
这不是插件问题，而是 VS Code 启动时没加载你的 shell 配置，导致它压根不知道 go 在哪，也看不到 GOPATH 或 GOPROXY。
尤其 macOS 用户开 VS Code 图形界面时，.zshrc 根本没执行过。
- 最简方案：从终端启动 VS Code，比如在 iTerm 里运行
code，这样环境变量全继承 - 或者，在 VS Code 设置里搜
go.goroot，手动填入/usr/local/go（Mac/Linux）或C:\Go（Windows） - 别只设
go.gopath，Go 1.16+ 已默认忽略它；重点确认go.toolsGopath是空值（让插件用模块模式） - 重启 VS Code —— 不是重载窗口，是彻底退出再打开，否则旧环境变量还在内存里
环境变量和模块路径这两层关系一旦错位，后续所有依赖管理、IDE 补全、测试运行都会连锁失败，比语法错误更难定位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
