GoLand 启动后必须手动指定 GOROOT，否则代码跳转、补全、构建均失效；需确认路径与 go version 一致，多版本管理时指向 asdf current golang 实际路径。

GoLand 启动后第一件事：手动指定 GOROOT，别信“Auto-detect”

GoLand 不会自动识别你系统里装的 Go，尤其当你有多个版本（比如同时装了 1.21 和 1.22），它大概率选错或直接空白。一旦 GOROOT 指向错误，后续所有代码跳转、补全、构建都会失效，但 IDE 很少报明确错误，只表现为“没提示”“Ctrl+Click 无反应”。

• 打开 Settings → Go → GOROOT（macOS 是 Preferences → Go → GOROOT）
• 点击右侧 New…，手动输入路径：/usr/local/go（macOS/Linux）或 C:\Go（Windows）
• 确认终端里 go version 输出的版本与此路径一致
• 如果用 asdf 或 gvm 管理多版本，务必指向当前 asdf current golang 返回的实际路径，不是软链接

调试器启动失败？先检查 dlv 是否安装且版本匹配

GoLand 默认调用 dlv 调试，但它不自带，也不自动帮你装。常见现象是点绿色虫子图标后进程瞬间退出、断点灰色不可用、控制台输出 could not launch process: fork/exec /path/to/dlv: no such file or directory —— 这说明根本没找到二进制。

• 在终端执行 dlv version；若报 command not found，运行：go install github.com/go-delve/delve/cmd/dlv@latest
• dlv 版本必须与 Go 版本兼容：Go 1.21+ 需 dlv ≥ 1.21，否则静默失败（不会报错，但调试器不工作）
• 在 Run → Edit Configurations → Go Build 中，确认 Debugger 设为 Delve，且 Path to dlv 指向你刚安装的二进制，例如：$GOPATH/bin/dlv
• 别把项目放在中文路径或含空格目录下（如 ~/Desktop/我的项目），dlv 在这类路径下常 fork 失败

代码补全/跳转失效？不是插件问题，是 gopls 没走通

GoLand 的语义分析底层依赖 gopls，但即使你已用 go install 装好，IDE 仍可能回退到旧的 go build 索引模式，导致 Ctrl+Click 跳不到定义、fmt.Sprintf 补全只出 fmt 前缀。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 确保 $GOPATH/bin 已加入系统 PATH，并在终端中能直接运行 gopls version
• 在 Settings → Go → Language Server 中，勾选 Enable language server (gopls)，并确认 Path to gopls 指向正确位置
• 右键项目根目录 → Reload project（不是重启 IDE），强制重新加载模块和 gopls 索引
• 如果项目用 Go Modules，确保 Settings → Go → Modules 中启用了 Enable Go modules integration，且 Proxy 设为 https://goproxy.cn（国内）或 https://proxy.golang.org（海外）

格式化与保存即生效：用 File Watchers 替代“自动格式化”开关

GoLand 内置的 go fmt 格式化选项（Settings → Editor → Code Style → Go）只处理基础缩进和空格，对 import 排序、缺失包自动引入等无效。真正要实现“Ctrl+S 就自动整理”，得靠 File Watchers 集成 goimports。

立即学习“go语言免费学习笔记（深入）”；

• 安装 goimports：go install golang.org/x/tools/cmd/goimports@latest
• 进入 Settings → Tools → File Watchers → + → Add Watcher
• 选 goimports 模板，关键设置：
  • Program 填 goimports（确保它在 PATH 中）
  • Arguments 填 -w $FilePath$
  • 勾选 Auto-save edited files to trigger watcher
• 这样每次保存，就等效于在终端执行 goimports -w main.go，import 自动分组、未用包自动删、缺失包自动加

GoLand 不是装完就能写代码的工具，它把配置权交还给你——而最容易被忽略的，恰恰是那些 IDE 不明说、但决定你能不能正常跳转、调试、格式化的底层路径和版本绑定。别省那几秒钟手动填 GOROOT，也别指望“自动检测”懂你的 asdf 切换逻辑。