goland核心功能依赖手动安装的gopls等工具，非内置或插件式启用；必须正确配置gopls路径、file watchers格式化规则及goproxy代理，否则智能提示、格式化、导入优化全部失效。

GoLand 本身不依赖“插件市场式扩展”来支持 Go 核心能力，gopls、go fmt、goimports 等关键工具必须手动安装并正确接入，否则智能提示、格式化、自动导入全失效——不是点几下鼠标就能开箱即用。

为什么不能只靠内置功能？gopls 是 Go 语言服务器的唯一事实标准

GoLand 的代码补全、跳转定义、重命名重构等功能，底层全部依赖 gopls。它不是 GoLand 自带的，也不是通过 Settings → Plugins 装个勾就能启用的。如果你没装或路径不对，你会遇到：

• Ctrl+B 跳转失败，提示 “Cannot find declaration to go to”
• 变量名右键 Rename 没反应，或只改了当前行
• 输入 http. 后无包内函数提示，补全列表空或只有基础类型

解决方法只有一条：确保 gopls 已安装且 GoLand 能定位到它。

执行：go install golang.org/x/tools/gopls@latest（注意不是 go get）

验证：gopls version 应输出类似 gopls v0.15.2；若报 command not found，说明 $GOPATH/bin 或 go install 默认路径未加入 PATH。

在 GoLand 中设置路径：Settings → Languages & Frameworks → Go → Go Language Server → 勾选 “Use custom path”，填入 gopls 的绝对路径（如 /Users/you/go/bin/gopls 或 C:\Users\you\go\bin\gopls.exe）。

File Watchers 不是可选项，是自动格式化的实际执行者

GoLand 的 “Save actions” 里勾选 “Reformat code” 对 Go 文件无效——Go 代码格式化必须走 gofmt 或 gofumpt，而触发机制靠的是 File Watchers 插件（默认已启用，但需手动配规则）。

常见错误现象：

• 保存后缩进还是 tab，go fmt 没跑
• 新增变量后 import 没自动加，甚至原有 import 被删掉
• 编辑器右下角显示 “Import optimization: disabled”

正确配置步骤：

Golang Uber Dig

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

下载

进入 Settings → Tools → File Watchers → 点 + → 选 go fmt 和 goimports（不是 “Go Format” 或 “Go Import” 这类名字相近的假选项）

关键参数检查：

• Program 必须填 gofmt 或 goimports 的绝对路径，不能只写命令名（尤其 Windows 用户常漏掉 .exe 后缀）
• Arguments 对 goimports 推荐填 -w $FilePath$，避免生成临时文件
• 务必勾选 “Auto-save edited files to trigger watcher”

别碰 GOPATH mode，模块代理才是日常卡顿的真正元凶

很多用户配完 SDK 和 gopls，一打开项目就满屏红色 import 报错，点进去全是 “Unresolved reference”。这不是插件问题，而是 go mod 下载失败导致的缓存污染。

典型表现：

• 项目有 go.mod，但 GoLand 右下角显示 “Loading modules…” 卡住不动
• 执行 go mod download 报错：proxy.golang.org: i/o timeout
• 手动运行 go mod tidy 成功，但 GoLand 仍不识别新包

解决方案分两步：

1. 设置国内代理（全局生效）：go env -w GOPROXY=https://goproxy.cn,direct

2. 在 GoLand 中刷新模块：File → Reload project，或点击右下角 “Load modules” 旁的刷新图标

如果仍不行，清空 GoLand 缓存：File → Invalidate Caches and Restart → Invalidate and Restart（注意：这会清除所有本地索引，首次重开较慢）

最易被忽略的一点：每次升级 Go 版本（比如从 1.21 到 1.23），gopls 必须重装，且 GoLand 的 SDK 配置要同步切换——旧版 gopls 在新版 Go 下可能静默崩溃，导致 IDE 功能间歇性失灵，但错误日志藏得很深，不会弹窗提醒。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！