VS Code正常加载gopls需三步：装好go命令、配对GOPROXY、删掉旧vendor/目录；go version报command not found是PATH未配置，需验证并修正GOROOT/bin路径。
装好 go 命令、配对 GOPROXY、删掉旧 vendor/ 目录，VS Code 就能正常加载 gopls —— 这三步做完，90% 的“环境搭不起来”问题就解了。
go version 报 command not found 怎么办
这不是 Go 没装好，是终端根本找不到 go 这个可执行文件。Windows 用户常卡在安装器勾选了“添加到 PATH”，但没重启 PowerShell；macOS/Linux 用户则多因 shell 配置没生效。
- Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里确认C:\Program Files\Go\bin（或你自定义的安装路径）进了PATH - macOS/Linux：运行
which go，没输出就检查/usr/local/go/bin是否加进~/.zshrc或~/.bash_profile，然后执行source ~/.zshrc - 别信“安装完就能用”——哪怕安装器声称自动配置，也必须新开终端验证
go mod init 失败或生成空 go.mod 怎么排查
常见现象是执行 go mod init example.com/project 后，go.mod 文件内容为空或模块名异常（比如变成 github.com/xxx/xxx/src/xxx），本质是当前目录处于旧式 $GOPATH/src 路径下，或残留了干扰项。
- 先运行
go env GOPATH，如果输出非空，再pwd看当前路径是否以$GOPATH/src开头 —— 是的话，切到任意其他目录再试 - 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor 模式） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 确保当前目录下没有
go.mod或go.sum—— 有就先删干净再 init
VS Code 里 gopls 启动失败或没提示
gopls 不是插件装上就跑，它依赖 go 命令可用、项目有合法 go.mod、且文件后缀为 .go。三个条件缺一不可。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
- 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），输入 “Go: Install/Update Tools”，勾选全部，点 “OK” —— 别跳过这步，否则gopls缺依赖会静默挂掉 - 检查项目根目录是否有
go.mod；如果没有，先go mod init xxx初始化 - 确认你打开的是整个项目文件夹（不是单个
.go文件）；VS Code 必须识别为 Go 工作区才能激活gopls - 国内用户务必配置代理：在终端运行
go env -w GOPROXY=https://goproxy.cn,direct，否则gopls启动时会卡在拉取golang.org/x/tools
要不要配 GOPATH 和 GOROOT
Go 1.16+ 已完全模块化，GOPATH 仅用于存放 go install 安装的二进制工具（如 gopls），GOROOT 一般也不需手动设 —— go 安装时已内置路径。
- 除非你要同时管理多个 Go 版本（比如用
asdf或gvm），否则不用碰GOPATH；GOBIN更没必要单独设 -
GOROOT几乎从不需改；go env GOROOT输出的路径就是它实际位置，改错会导致go命令直接瘫痪 - 真正要盯住的是
GOPROXY和GO111MODULE—— 这俩才是影响日常开发流畅度的关键开关
最易被忽略的点：很多人反复重装 VS Code 插件或 Go，却忘了 go mod init 前必须离开 $GOPATH/src；还有人以为 gopls 启动失败是插件问题，其实只是 go.mod 缺失或 GOPROXY 没生效。
