Cursor默认不带Go语言LSP支持，必须手动安装gopls和dlv，通过绝对路径在settings.json中配置"go.useLanguageServer":true及"go.goplsArgs"，并确保项目根目录含go.mod，否则补全、跳转、调试全部失效。
cursor 默认不带 go 语言 lsp 支持，必须手动配置 gopls 并显式启用调试器 dlv；否则补全、跳转、断点全部失效，连 go mod init 都可能被误报为错误。
确认 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 install golang.org/x/tools/gopls@latest安装，不要用已弃用的go get - 检查项目根目录是否有
go.mod—— 没有它，gopls无法识别模块结构，所有跳转和 import 补全都会静默失败
在 Cursor 中配置 gopls 作为 LSP 服务
Cursor 使用 VS Code 兼容的设置体系，需通过 settings.json 手动指定 LSP 启动参数。默认配置不会自动发现 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 格式化，还需在 go.goplsArgs 中追加："-formatting.gofumpt=true" 和 "-semanticTokens=true"
配置 dlv 实现一键 Debug（非 launch.json 方式）
Cursor 不依赖传统 .vscode/launch.json，而是通过内置的 “Run and Debug” 视图 + 文件上下文自动推导调试目标。但前提是 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启动调试会话
若断点灰色不可用，大概率是 dlv 路径未被识别，或当前文件不在模块根目录下（go run . 无法运行的地方，dlv 也无法调试）。
常见卡点与绕过方式
Cursor 对 Go 的支持比 VS Code 更“薄”一层，很多问题表面是 LSP 失效，实际是底层工具链未对齐。最常被忽略的是模块初始化时机和工作区边界。
-
gopls卡在 “starting…”：不是配置错，而是 Cursor 当前打开的是单个.go文件，而非包含go.mod的文件夹 —— 关闭文件，用 “File → Open Folder” 重新打开整个模块根目录 - Debug 时提示 “could not launch process”：检查
dlv是否有执行权限（macOS/Linux 运行chmod +x $(go env GOPATH)/bin/dlv） - 自动补全只出关键词、不出函数签名：关闭所有其他 Go 插件（尤其是旧版 GoSublime 类插件），它们会劫持
gopls端口导致冲突 - 格式化后 import 顺序混乱：把
"go.formatTool"设为"gofumpt"，并确保gopls启动参数含-formatting.gofumpt=true
真正难调的从来不是配置项本身，而是 Cursor 启动时捕获的环境快照与你在终端里看到的不一致 —— 所有路径都必须绝对，所有工具都必须可执行，所有模块都必须从根开始打开。
