gopls未启动导致补全跳转失效，需手动安装并用绝对路径配置；缺go.mod、dlv未正确安装或PATH未包含$GOPATH/bin会导致调试失败；需在配置中启用-formatting.gofumpt=true和-semanticTokens=true，并重启Cursor。
gopls没启动，补全和跳转全失效
cursor默认不带go语言服务器，gopls必须手动安装并用绝对路径硬编码进配置——哪怕终端里gopls version能跑通，编辑器内仍会静默失败。根本原因是cursor启动时不继承shell的$path。
执行以下操作：
- 在终端运行
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） - 打开
Command Palette（Cmd+Shift+P / Ctrl+Shift+P），输入 “Preferences: Open Settings (JSON)” - 添加如下配置（替换
command中的路径）：{ "go.useLanguageServer": true, "go.goplsArgs": ["-rpc.trace"], "go.languageServerFlags": [], "go.toolsEnvVars": { "GO111MODULE": "on" } }
缺 go.mod？补全也会静默挂掉。确保项目根目录存在该文件，否则 gopls 压根不识别模块结构。
dlv调试断点灰色、点不动
断点不可用，90%是 dlv 没被正确识别，或当前文件不在可运行的模块上下文中。Cursor不走.vscode/launch.json那一套，而是靠自动推导 + dlv dap 启动。
检查三件事：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest，然后dlv version输出必须含Version: 1.21.或更高（低版本会在断点处直接退出，无提示） -
$GOPATH/bin必须在系统PATH中——Cursor启动时只读这个环境变量来定位dlv - 右键点击
main.go→ “Debug”，或按 Cmd+D / Ctrl+D；若失败，先确认go run .能否在当前目录成功运行
注意：调试器只对含 func main() 的包生效。非 main 包里的断点不会激活。
格式化和语义高亮不起作用
默认配置下，gopls 不开格式化和语义高亮。补全有、但代码乱、变量没颜色，大概率是参数漏了。
在 go.goplsArgs 数组里追加两个开关：
-
"-formatting.gofumpt=true"：启用gofumpt强制风格（比go fmt更严格） -
"-semanticTokens=true"：开启语义高亮（函数名、类型、常量等不同颜色）
改完保存配置，重启Cursor。别指望热重载——LSP服务不会自动 reload 参数。
AI写Go代码时老忽略项目规范
Cursor的AI（比如Claude）默认不知道你的 import 分组规则、错误处理习惯或 context 使用方式。它会按通用Go惯例生成，可能和你项目实际风格冲突。
有两个低成本办法提升命中率：
- 在聊天框里用
@显式引用关键文件，比如@go.mod、@internal/handler/user.go，让AI感知模块结构和已有模式 - 在项目根目录建一个
.cursor/rules.md，写几条白话规则，例如：“所有 HTTP handler 必须接收 *gin.Context，返回 error”<br>“error 变量统一命名 err，不许用 e 或 errorx”<br>“import 必须分三组：标准库、第三方、内部模块”
规则越具体，AI越少“自由发挥”。别写抽象原则，写可执行的句式模板。
最常被忽略的一点：所有配置变更后必须重启Cursor，不是重载窗口。LSP和dlv进程绑定在主进程生命周期里，热更新不生效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
