gopls未启动需手动配置绝对路径并确保go.mod存在：在settings.json中显式设置"go.useLanguageServer": true和"go.goplsArgs"，用which/where获取的完整路径硬编码，禁用go.goplsPath空值或相对引用，同时验证dlv≥1.21且GOPATH/bin在系统PATH中。
gopls没启动？先确认它是否真被Cursor读到
cursor 启动时不继承 shell 的 $path，哪怕你在终端里执行 gopls version 正常，编辑器内仍会显示 “lsp not found”。这不是安装失败，而是路径不可见。
- 在终端运行
which gopls（macOS/Linux）或where gopls（Windows），记下完整路径，例如/Users/xxx/go/bin/gopls或C:/Users/xxx/go/bin/gopls.exe - 必须用这个绝对路径硬编码进配置，不能写
"go.goplsPath": "gopls"或留空 - 验证是否装对：执行
go install golang.org/x/tools/gopls@latest，别用已弃用的go get - 检查项目根目录是否有
go.mod——没有它，gopls无法识别模块结构，所有跳转和 import 补全都会静默失败
settings.json里怎么配gopls才生效
Cursor 使用 VS Code 兼容的设置体系，go.useLanguageServer 必须显式设为 true，且需配合 go.goplsArgs 控制行为。默认配置不会自动发现 gopls，哪怕它在系统 PATH 里。
- 打开 Command Palette（
Cmd+Shift+P/Ctrl+Shift+P），输入 “Preferences: Open Settings (JSON)” - 添加以下块（注意替换
command中的路径）：
{
"go.goplsArgs": ["-rpc.trace"],
"go.useLanguageServer": true,
"go.languageServerFlags": [],
"go.toolsEnvVars": {
"GO111MODULE": "on"
}
}
- 如需语义高亮或
gofumpt格式化，追加："-formatting.gofumpt=true"和"-semanticTokens=true" -
go.useLanguageServer设为false会让 Cursor 彻底放弃gopls，所有补全都交给 AI 模型硬猜——中小型项目都容易错，不建议关
补全字段总是错？不是模型问题，是上下文缺失
Cursor 的 auto-complete 在 Go 中补出错误 struct 字段，根本原因不是模型“不懂 Go”，而是 gopls 没拿到足够信息：它没读取 go.mod 里的依赖版本，也看不到未 import 的包中定义的类型。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确保项目根目录有正确
go.mod，且已运行过go mod tidy；否则gopls解析依赖失败，LSP 补全直接失效 - 手动
import所需包（哪怕只用一次），不要依赖 Cursor 自动补全 import 行——它常漏掉别名字或间接依赖 - 触发补全后按
Ctrl+Space（macOS 为Cmd+Space）可强制只显示 LSP 原生结果，绕过 Cursor 的重排序干扰 - 右下角补全项标着 “AI” 表示走本地小模型，“LSP” 表示来自
gopls；但即使显示 LSP，也可能被插件拦截并把高频字段（如Err、Data）往前顶
断点灰色不可用？大概率是dlv没被识别或模块没加载
Cursor 不依赖 .vscode/launch.json，而是通过文件上下文自动推导调试目标。但前提是 dlv 必须可用，且版本 ≥ 1.21 —— 低版本会在断点处直接退出，无任何错误提示。
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest安装最新dlv - 验证：
dlv version输出应含Version: 1.21.或更高 - 确保
$GOPATH/bin在系统PATH中（Cursor 启动时会读取该环境变量，用于定位dlv） - 在
main.go文件中右键 → “Debug” 或按Cmd+D（macOS）/Ctrl+D（Windows/Linux），Cursor 会自动调用dlv dap启动调试会话 - 断点灰色 = 当前文件不在模块根目录下（
go run .无法运行的地方，dlv也无法调试）
