项目级格式化需以go.mod存在为前提，goland仅在module根目录及子目录下启用goimports管理import；settings→languages & frameworks→go→formatting中须勾选reformat on save和run goimports，并配合.gofumpt或.editorconfig统一团队规则。
项目级格式化配置必须基于 go.mod 存在
GoLand 不会为任意目录启用 import 管理或模块感知格式化。只有当前文件位于有效 Go module 根目录（即包含 go.mod）及其子目录下，goimports 才会解析包路径、增删/分组 import 块。否则它直接跳过 import 处理，只做基础缩进调整——这正是很多人配对了却“import 没动”的根本原因。
验证方式：在终端进入该目录，执行 go list -m；若报错 go: not in a module，说明不满足前提。
Settings → Languages & Frameworks → Go → Formatting 是主开关
这个路径是唯一能同时控制“是否触发”和“用什么工具”的地方，不是 File Watchers 或 Code Style 里的 Formatter 标签页。
- 必须勾选
Reformat on save—— 否则保存动作不会调用任何格式化逻辑 - 必须勾选
Run goimports（不是Run gofmt）—— 因为gofmt不处理 import，而goimports兼容gofmt行为且额外管理导入 - 如果右侧显示
Command not found，点击…手动指定路径，常见为$GOPATH/bin/goimports或~/go/bin/goimports - 改完不生效？先执行
File → Invalidate Caches and Restart，缓存不刷新会导致旧配置残留
不要用 File Watchers 替代 Reformat on save
File Watchers 在非 module 目录下运行时，工作目录是当前文件所在路径，goimports 无法向上找到 go.mod，结果就是 import 块完全不动；而且它监听的是文件变更事件，可能在 IDE 自动保存、编辑器失焦等场景重复触发，导致 import 被删又加、短暂编译失败。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
如果你已经配了 File Watchers，请禁用它，专注用上面那个 Settings 路径的组合——这才是 GoLand 官方推荐、模块感知、可预测的路径。
团队项目需配合 .gofumpt 或 .editorconfig 固化规则
单靠 IDE 设置无法保证所有人格式一致。真正起作用的是项目根目录下的显式声明：
- 放一个空的
.gofumpt文件，GoLand 检测到后会自动用gofumpt替代默认gofmt，它比goimports更严格（比如强制括号换行、禁止冗余括号） -
.editorconfig只影响缩进风格（如indent_style = space），不影响goimports行为，但能防止混用 tab/space - CI 中必须跑
goimports -l ./或gofumpt -l ./，非零退出就拒绝 PR——这是最后一道防线
最容易被忽略的，是 go.mod 的存在与否这个隐性前提。路径、命令、勾选项全对，只要文件不在 module 根目录下，goimports 就不会碰 import 行，连错误提示都不会有。
