Go开发环境核心是gopls运行、go.mod识别和dlv调试三要素；缺一不可，否则补全失效、跳转报错、断点灰掉。
Go 语言开发环境配得对不对，不看插件装了多少，而看 gopls 跑没跑起来、go.mod 有没有被识别、dlv 能不能调试。其他都是锦上添花，这三个没稳，补全失效、跳转报错、断点灰掉全是必然。
确认 gopls 已安装且版本兼容
几乎所有“没提示”“跳不到定义”“保存不格式化”的问题，根源都在 gopls 没就位。它不是 IDE 自带的，也不是 Go 安装包附赠的——必须手动或由插件触发安装。
- 终端运行
gopls version，有输出才说明已安装；若提示command not found，执行go install golang.org/x/tools/gopls@latest（Go 1.21+ 用户建议加具体版本，如@v0.14.2，查兼容性表更稳妥） - VS Code 中不要依赖弹窗自动安装——网络不稳定时它常静默失败；务必手动运行命令面板里的
Go: Install/Update Tools，并单独勾选gopls - GoLand 不需要你装
gopls，但它默认启用；如果代码无响应，检查Settings → Languages & Frameworks → Go → Go Modules是否勾选了Enable Go modules integration，未勾选会导致模块索引直接跳过 - 多 Go 版本共存时，VS Code 需显式指定路径：
"go.goplsPath": "/home/user/go/bin/gopls"，否则可能调用到旧版gopls导致 panic 或卡死
项目必须是 Go Modules 模式
gopls 和现代 IDE 的所有智能功能，都建立在 go.mod 文件存在且有效的基础上。没有它，VS Code 会退化成纯文本编辑器，GoLand 会拒绝加载依赖、提示 no packages found for open file。
- 新建项目：VS Code 打开空文件夹后，先运行
go mod init example.com/myapp；GoLand 新建项目时务必勾选Initialize module with go.mod，module name 必须是合法导入路径（不含空格、大写字母） - 已有项目没
go.mod？别只敲go mod init就完事。GoLand 下要右键目录 →Load project as Go module；VS Code 下需关闭当前窗口，重新用File → Open Folder打开该目录，强制触发模块识别 - 子模块（如
api/、shared/各有go.mod）在单个 VS Code 窗口里容易失效。要么为每个子模块单独开窗口，要么在.vscode/settings.json中启用实验性支持："go.gopls": { "experimentalWorkspaceModule": true }
调试器 dlv 必须能被 IDE 找到
断点灰色、F5 按下没反应、提示 dlv not found，不是没装，而是 IDE 没 PATH 到它。尤其 GoLand 默认不自动安装 dlv，VS Code 插件有时也漏装。
立即学习“go语言免费学习笔记（深入）”；
- 先确保终端能运行：
dlv version。若不行，执行go install github.com/go-delve/delve/cmd/dlv@latest - VS Code：确认
$HOME/go/bin（或自定义go.toolsGopath）已在系统PATH中；插件设置里"go.useLanguageServer": true必须开启（设为false会彻底禁用调试支持） - GoLand：进入
Settings → Languages & Frameworks → Go → Debug → Delve，点击Install按钮（别信“自动检测”，它经常不动） - 远程调试或容器内调试时，
dlv必须和目标环境的 Go 版本匹配。本地go version是 1.22，但容器里是 1.20？那得在容器里单独装对应版本的dlv
别让 GOPATH 和 toolsGopath 搞混
这两个配置项是高频误配点。go.gopath 在 Go 1.16+ 已废弃，go.toolsGopath 只控制 gopls、dlv 等工具二进制的存放位置，**不是项目源码路径**。
- 把项目目录设为
go.toolsGopath，gopls会试图扫描整个项目当 GOPATH，轻则卡顿，重则内存爆满崩溃 - 推荐留空
go.toolsGopath，让它用默认值（$HOME/go/bin），然后确保该路径在系统PATH中。Windows 用户注意路径分隔符是;不是: - 如果你非要用自定义工具路径（比如
/opt/go-tools），那就得手动改 shell 的PATH：export PATH="/opt/go-tools:$PATH"，IDE 重启后才生效 - 真正影响项目构建的是
GOROOT（Go 安装根目录）和go.mod，不是这些路径设置。GoLand 里填 SDK 路径时，填/usr/local/go，不是/usr/local/go/bin——后者是常见错误
最常被忽略的其实是工作区状态：IDE 认不认得你是 Go 项目，不取决于你装了多少插件，而取决于它打开的那一刻，有没有在当前目录或父级目录里找到 go.mod。哪怕只差一层目录，gopls 就不会启动，所有高级功能全部哑火。
