装完就能用，但go version报错、go mod init生成空go.mod、vs code无代码提示才是真卡点；主因是path未生效、旧项目残留干扰、gopls依赖缺失或goproxy未配置。
装完就能用，不用折腾 IDE；但 go version 报错、go mod init 生成空 go.mod、VS Code 里没代码提示——这些才是真卡点。
go version 找不到命令？PATH 没生效是主因
Windows 用户双击 .msi 安装后，必须关掉所有 CMD/PowerShell 窗口再重开，否则系统 PATH 不刷新。macOS/Linux 装完 .pkg 或 brew install go 后，也要确认 shell 配置文件（~/.zshrc 或 ~/.bash_profile）里加了 /usr/local/go/bin，然后执行 source ~/.zshrc。
- 验证方式：运行
which go（macOS/Linux）或Get-Command go（PowerShell），有输出才算真正可用 - 别信安装器“自动添加 PATH”的勾选项——它只改注册表或配置文件，不立即生效
- 如果手动解压
.tar.gz到/usr/local/go，记得补上export GOROOT=/usr/local/go，否则某些工具（如gopls）可能找不到标准库
go mod init 失败？旧项目残留干扰最常见
在已有代码的目录下直接跑 go mod init，常会静默失败或生成错误模块名，尤其当目录还在 $GOPATH/src 下、或存在 vendor/ 目录时。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 先清理：删掉项目根目录下的
vendor/（除非你明确要 vendor 依赖） - 检查当前路径是否在
$GOPATH/src内——如果是，切到任意其他目录再初始化 - 强制启用模块模式：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 模块名建议用域名格式，比如
go mod init example.com/myapp，避免纯英文名引发后续导入冲突
VS Code 里 gopls 启动失败？三个硬性前提缺一不可
gopls 不是插件装上就跑，它依赖底层 go 命令可用、项目有 go.mod、且文件后缀是 .go。
- 打开文件夹前，确保已运行过
go mod init并生成go.mod - 文件必须保存为
main.go（不是main.txt或未命名缓冲区） - 检查
go env GOPROXY，国内用户建议设为https://goproxy.cn,direct，否则gopls初始化时下载工具包会卡住 - 插件设置里确认
"go.useLanguageServer": true，禁用旧版go.toolsGopath类配置
最易被忽略的是：模块初始化和编辑器启动都依赖当前目录结构合规，而不是单纯“装了 go”。哪怕 go version 成功，进错目录、留着 vendor/、或没设代理，照样寸步难行。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
