gopls 报 “no workspace found” 是因未启用 Go modules：需在项目根目录运行 go mod init 创建 go.mod；调试失败因 dlv 未安装或 PATH 不匹配；补全延迟高可禁用 semanticTokens。
Go modules 未启用导致 gopls 报 “no workspace found”
这是新手配置 gopls 时最常卡住的地方：明明装了 gopls，Vim 里一打开 .go 文件就提示 no workspace found。根本原因不是插件没装对，而是 gopls 默认只认 Go modules 工作区——它不支持 GOPATH 模式下的旧项目结构。
实操建议：
- 在项目根目录运行
go mod init your-module-name（模块名可以是任意合法字符串，如example.com/foo或直接用main） - 确认项目下生成了
go.mod文件；没有它，gopls就不会启动语言服务器 - 如果项目已有
vendor/目录，别删——gopls仍会读go.mod，但会从vendor/解析依赖 - 避免把
.go文件单独放在空目录里测试，这种“文件级打开”场景下gopls找不到模块边界，直接退回到无功能状态
gopls 配置项 build.directoryFilters 控制索引范围
默认情况下 gopls 会递归扫描整个项目目录，包括 node_modules、build/、bin/ 这类无关子目录，导致启动慢、内存飙升，甚至触发 Linux 的 inotify 限制报错 inotify watch limit reached。
实操建议：
- 在
gopls配置中显式设置build.directoryFilters，例如："build.directoryFilters": ["-node_modules", "-build", "-bin", "-dist"]
- 过滤符前的
-表示排除，必须带；写成"node_modules"不生效 - 路径匹配基于目录名，不支持通配符或正则；
-testdata能排除所有叫testdata的目录，但不能写成-*data - 如果项目含多个
go.mod（如 monorepo），每个子模块需各自有go.mod，否则gopls只认最外层那个
Vim 中 :GoDebugStart 失败：找不到 dlv 或提示 “connection refused”
vim-go 的调试功能依赖 dlv（Delve）二进制，但它不会自动安装，也不会复用系统 PATH 里可能存在的旧版本。常见错误信息包括：dlv: command not found、connection refused、或 could not launch process: fork/exec ... no such file or directory。
实操建议：
- 手动安装匹配 Go 版本的
dlv：GO111MODULE=on go install github.com/go-delve/delve/cmd/dlv@latest（注意不是go get） - 检查
dlv是否在 Vim 的 PATH 里：在 Vim 中执行:!which dlv；如果为空，说明 Vim 启动时没加载 shell 的 PATH，需在.vimrc中加set shell=/bin/bash或类似配置 -
:GoDebugStart默认监听localhost:2345，若端口被占，改用:GoDebugStart -port=2346；但别用高位端口（如 60000+），某些 Linux 发行版会限制非 root 用户绑定 - 调试时确保当前缓冲区是可执行的
main.go，且项目已go mod init；否则dlv启动后立即退出，Vim 显示 “connection refused”
补全延迟高或结构体字段不显示：关掉 gopls 的 semanticTokens
开启语义高亮（semanticTokens）会让 gopls 在补全时额外分析符号类型，对小项目无感，但在含大量第三方依赖（如 k8s.io、istio）的项目里，会导致 gopls CPU 占用持续 80%+，补全响应拖到 2–3 秒，甚至结构体字段补全完全不出现。
实操建议：
- 在
gopls配置中禁用："semanticTokens": false
- 这个选项不影响基础补全（函数名、包名、变量名），只影响字段、方法、类型等“语义级”补全项的实时性
- 若你确实需要结构体字段补全，可保留
semanticTokens，但务必配合build.directoryFilters排除无关目录，否则性能雪崩 - Neovim 用户注意：
nvim-lspconfig默认启用semanticTokens，需在gopls.setup({})的settings里显式关掉
gopls 对模块边界的敏感、dlv 和 Vim 环境变量的隐式耦合、以及那些默认开启却没人告诉你代价的配置项。这些点不手动掰开调，IDE 级体验就永远差一口气。 
