Emacs搭建Go环境关键在gopls、dlv与Emacs配置三者路径和版本对齐；gopls须用go install安装并验证version，dlv需v1.21.0+且设dap-dlv-go-dlv-command为"dlv"，补全慢应禁用lsp-go-analyze-tests等耗CPU项，改go.mod后须手动lsp-go-reload-project。
Emacs 搭建 Go 环境不是“装完插件就能用”，关键在 gopls、dlv 和 Emacs 配置三者路径与版本对齐；错一个，补全失效、跳转卡死、调试卡在 “Starting dlv-dap” 就是常态。
gopls 必须用 go install 装，且版本要匹配 Go SDK
很多人用 brew install gopls 或旧版 go get，结果 lsp-mode 连不上——因为路径不对或 ABI 不兼容。Go 1.21+ 已弃用 go get 安装语言服务器，必须用：
go install golang.org/x/tools/gopls@latest
装完立刻验证：
- 终端运行
gopls version，输出应含golang.org/x/tools/gopls v0.14.0类似字样（版本号需 ≥ Go SDK 主版本） - Emacs 启动后执行
M-x lsp-describe-session，确认显示的gopls路径和终端里which gopls一致 - 若不一致，检查
exec-path和PATH是否被 Emacs 配置覆盖（比如use-package初始化顺序导致环境变量未加载）
dlv-dap 调试失败？先看 dlv 版本和命令名
dap-mode 卡在 “Starting dlv-dap” 几乎全是 dlv 问题，不是配置写错了。
立即学习“go语言免费学习笔记（深入）”；
- 运行
dlv version，输出中必须同时包含：Build Type: Static和DAP Support: true - 别再用
go get github.com/go-delve/delve/cmd/dlv—— 这装的是 legacy 分支，无 DAP 支持 - 正确安装方式：
go install github.com/go-delve/delve/cmd/dlv@latest
- 新版
dlv只提供一个二进制，但dap-mode默认找dlv-dap。必须显式指定：(setq dap-dlv-go-dlv-command "dlv")
- 调试前确保当前 buffer 是
.go文件，且项目根目录存在go.mod；否则dap-mode会静默失败，不报错也不启动
补全慢、跳转卡？关掉 gopls 的分析开关
不是 Emacs 卡，是 gopls 在后台做全量语义分析，尤其开启 gopls.analyzeTests 后，中大型项目首次索引可能吃满 CPU 并阻塞响应。
- 在
lsp-mode配置中禁用耗资源项：(setq lsp-go-analyze-tests nil lsp-go-staticcheck nil lsp-go-gofumpt nil) - 改过
go.mod后，gopls不会自动重载依赖，必须手动触发：M-x lsp-go-reload-project - 如果只写 CLI 工具或小项目，甚至可关闭类型推导：
"semanticTokens": false加到lsp-go-server-initialization-options
多项目切换时 GOPATH 不生效？别碰 GOPATH
Go Modules 已淘汰 GOPATH 项目管理，Emacs 里硬拼接多个路径到 GOPATH 环境变量，反而会让 gopls 索引混乱、跳转错乱。
- 现代 Go 项目靠
go.mod定位模块边界，gopls自动识别工作区根目录（即含go.mod的最上层目录） - Emacs 中打开任意
.go文件后，执行M-x lsp-workspace-folders-add手动添加项目根，比改GOPATH更可靠 - 若仍需支持无
go.mod的老项目，用goflymake+go build做语法检查即可，不必强求gopls全功能
真正麻烦的从来不是配置几行代码，而是终端里能跑通的命令，在 Emacs 子进程中因环境隔离、初始化时机或 PATH 截断而失效——每次怀疑配置错了，先在 Emacs 内 M-! 运行 which gopls 和 gopls version，比翻 config 快十倍。
