goland默认不自动整理import，必须显式启用goimports并关闭gofmt干扰；需安装goimports@latest、确保path可达、在settings→code style→go中选external formatter为goimports、启用file watchers且项目含go.mod。
GoLand 默认不自动整理 import，必须显式启用 goimports 并关闭 gofmt 的干扰项，否则保存时只会格式化、不会增删或重排 import。
确认 goimports 已正确安装且可调用
GoLand 不自带 goimports，它只是调用你系统 PATH 中的二进制。如果没装或路径不对，保存时“看似生效”，实则 import 一条都不动。
- 终端执行
goimports -v，应输出版本信息（如golang.org/x/tools/cmd/goimports v0.18.0） - 若报 command not found，请运行：
go install golang.org/x/tools/cmd/goimports@latest - 安装后检查
$GOBIN或$GOPATH/bin是否在系统 PATH 中（echo $PATH可验证） - Go 1.21+ 推荐用
@latest，避免因版本过旧导致不支持泛型 import 分组
GoLand 设置里启用 goimports 而非 gofmt
Settings > Editor > Code Style > Go > Formatter 面板中，“Use external formatter” 必须勾选，且下拉菜单选 goimports —— 这是唯一能同时格式化 + 自动管理 import 的选项。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 不要选
gofmt：它只格式化，不碰 import，哪怕你勾了 “Optimize imports on the fly” 也无效 - 确保 “Run goimports” 选项（在 Settings > Go > Formatting 页面）已勾选，这是 GoLand 2024.3+ 的独立开关
- “Optimize imports on the fly” 是 IDE 内部行为，仅对新增代码起效；真正批量整理靠保存触发的
goimports
保存时触发的底层逻辑与常见失效场景
GoLand 实际是通过 File Watchers 在文件保存后调用 goimports -w <file></file>。这个链条任何一环断掉，import 就不会动。
- File Watchers 插件必须启用（Preferences > Plugins > 搜索并确认
File Watchers已开启） - Settings > Tools > File Watchers 里不能有多个冲突的 Go watcher；建议删除所有自定义 watcher，只保留 GoLand 自动生成的那个
- 项目必须处于 Go Module 模式（根目录含
go.mod），否则goimports无法识别包路径，可能漏删未使用 import - 如果用了 vendor 目录，
goimports默认仍会处理 vendor 下的 .go 文件，但通常你不想改它们 —— 此时需手动加-exclude=vendor参数（见下条）
定制 goimports 行为：排除 vendor / 添加分组规则
goimports 默认行为有时不符合团队规范，比如 vendor 文件被误改、标准库和第三方 import 混在一起。这些不能靠 GoLand UI 设置，得靠命令行参数。
- 进入 Settings > Tools > File Watchers > goimports watcher > Edit > Arguments，把默认
--srcdir $ProjectFileDir$ --mode diff $FilePath$改成：-w -local github.com/yourorg -exclude=vendor $FilePath$ -
-local参数让第三方包（如github.com/...）和标准库分开，符合 Go 官方 import 分组建议 -
-exclude=vendor防止修改 vendor 目录下的文件，避免 CI 构建失败 - 注意：GoLand 不支持传入
-d（diff 模式），必须用-w才能写回文件，否则保存后无变化
真正起作用的是 goimports -w 命令本身，不是 GoLand 的某个开关。只要它在 PATH 里、参数配对、项目是 module、File Watchers 没被禁用，保存那一刻 import 就会实时刷新 —— 否则就卡在某一个环节，得挨个排查。
