根本原因是PATH未包含Go的bin目录，导致系统找不到go可执行文件；需确认Linux/macOS中PATH含/usr/local/go/bin或Windows中PATH含%GOROOT%in，并在新终端验证go version。
go env -w 配置后 go version 仍报错或不生效
根本原因通常是 PATH 没包含 /usr/local/go/bin（Linux/macOS）或 %GOROOT%in（Windows），导致系统找不到 go 可执行文件。
- Linux/macOS：检查
echo $PATH输出是否含/usr/local/go/bin；若无，确认~/.bashrc或~/.zshrc中已追加export PATH=$PATH:/usr/local/go/bin，并执行source ~/.bashrc - Windows：在“系统属性 → 环境变量”中检查
PATH是否含%GOROOT%in，且GOROOT值为实际解压路径（如D:go），不是D:goin - 验证命令必须在新终端运行：
go version成功才说明环境变量真正加载
编译时报错 cannot find module providing package
这是 Go modules 启用后最典型的依赖定位失败，不是代码写错了，而是模块感知机制没触发或代理失效。
- 确保项目根目录下有
go.mod文件：没有就先运行go mod init example.com/myapp - 检查
GO111MODULE是否为on：运行go env GO111MODULE，输出应为on；若为auto，在 GOPATH 外的目录可能不启用 modules - 国内用户必须设
GOPROXY：推荐执行go env -w GOPROXY=https://goproxy.cn,direct，避免直连proxy.golang.org超时 - 若仍失败，尝试
go clean -modcache清掉本地缓存再go mod tidy
go build 生成二进制却无法运行：no such file or directory
常见于 Linux 上交叉编译或静态链接缺失，尤其是用 alpine 镜像运行时提示 not found，实际是动态库依赖问题。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 默认
go build生成的是动态链接可执行文件，依赖宿主机的 libc；在 alpine（musl libc）上会直接报错 - 解决方法：编译时加
-ldflags '-s -w' -a -installsuffix cgo，或更彻底地用CGO_ENABLED=0 go build - 验证是否静态链接：运行
ldd myapp，若输出not a dynamic executable，说明已静态编译成功 - 注意：禁用 cgo 后无法使用依赖 C 的包（如
net在某些 DNS 场景下受限），需权衡
VSCode 中 go 命令可用但插件提示 “command not found”
VSCode 的终端继承了 shell 环境变量，但 GUI 启动的 VSCode 可能读不到 ~/.bashrc，导致插件内部调用 go 失败。
立即学习“go语言免费学习笔记（深入）”；
- macOS：编辑
~/Library/Application Support/Code/User/settings.json，添加"go.goroot": "/usr/local/go" - Linux：启动 VSCode 前先在终端运行
code --no-sandbox，确保继承当前 shell 环境 - Windows：检查 VSCode 设置里
go.goroot是否指向正确路径（如D:\go），且路径中不含空格或中文 - 重启 VSCode 并按
Ctrl+Shift+P→ “Go: Install/Update Tools”，确保dlv、gopls等工具装在$GOBIN下而非默认$GOPATH/bin
go build 卡在第一步。很多人反复重装 Go，其实只是 GOPROXY 没配或 PATH 没刷进去。 
