goimports 必须手动安装并正确配置路径，启用 file watchers 监听器，项目需有有效 go.mod 文件，且 formatting 设置不能与 file watchers 冲突，否则 import 不会自动整理。
goimports 必须装好且路径正确
GoLand 不自带 goimports，它只负责调用——你得自己装，而且 IDE 得找得到。终端执行 goimports -version 报 command not found？立刻运行：
go install golang.org/x/tools/cmd/goimports@latest
装完检查是否在 $PATH 里：echo $PATH | grep "$(go env GOPATH)/bin"。如果没匹配上，要么把 $(go env GOPATH)/bin 加进系统 PATH，要么在 GoLand 的 Settings → Tools → File Watchers → goimports 配置里手动填绝对路径（比如 /Users/xxx/go/bin/goimports 或 C:\Users\xxx\go\bin\goimports.exe）。
File Watchers 必须启用 goimports 监听器
GoLand 默认不开启保存即整理依赖，靠的是 File Watchers 插件触发 goimports -w。确认步骤：
- 打开
Settings → Plugins，搜File Watchers，确保状态是 Enabled - 进入
Settings → Tools → File Watchers，看列表里有没有goimports；没有就点+→ 选模板goimports - 关键参数检查：
Program指向goimports可执行文件，Arguments应为-w $FilePath$，Working directory留空（让工具自动推导模块根目录） - 勾选
Auto-save edited files to trigger watcher和Trigger watcher on external changes
漏掉任意一项，保存时 import 就不会删、不会排、不会加。
项目必须有有效的 go.mod 文件
goimports 不是纯文本格式器，它依赖 go list 解析模块路径来判断哪些包该留、哪些该删、怎么分组。常见失效场景：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在没
go.mod的目录下编辑.go文件 →goimports静默跳过 import 处理，只做基础缩进 -
go.mod存在但内容损坏（比如module行为空或非法字符）→goimports无法推断 import path，可能误删合法包 - 用
replace或vendor但没同步更新go.sum→goimports识别不到本地路径映射，导致新增 import 时找不到包
验证方式：终端进项目根目录，运行 go list -f '{{.ImportPath}}' .，能正常输出模块路径才算过关。
Settings 里的 Formatting 设置不能和 File Watchers 冲突
GoLand 有两个地方能控制“保存时格式化”，但只有一个是管 import 的：
-
Settings → Languages & Frameworks → Go → Formatting：这里只控制缩进、空格、括号换行等，勾选Reformat on save不会影响 import -
Settings → Tools → File Watchers：这才是真正调用goimports -w整理依赖的地方
如果只开了前者，保存后你会发现代码缩进整齐了，但多余的 "fmt" 还在、新引入的包没自动加、import 分组乱序——因为 gofmt 根本不碰 import 声明。别指望 Formatting 页面里的 “Run goimports” 勾选项，2023.3 版起 JetBrains 已把它移除，统一交给 File Watchers 管理。
最容易被忽略的一点：改完 File Watchers 配置后，得关掉当前文件再重新打开，或者重启 GoLand —— 缓存不刷新，新规则压根不生效。
