goimports必须替代gofmt，因其是后者的超集，不仅能格式化代码（缩进、括号等），还自动增删import、按标准库/第三方/本地分组、字母排序；而gofmt完全不处理import，ide内置格式器同理，仅靠它们会导致import混乱、ci检查失败。
GoLand 默认不自动调用 goimports，只用内置格式器或 gofmt —— 这会导致 import 语句不增删、不排序、不分组，实际项目中几乎等于没格式化。
为什么不能只用 gofmt 或 IDE 内置格式器
gofmt 只处理缩进、括号、空格等语法结构，完全不管 import 块。比如删掉一个包引用后，它不会帮你删掉对应 import；新增一个 fmt.Println，它也不会自动加 "fmt"。IDE 内置格式器在语法错误时更鲁棒，但同样跳过 import 管理。团队协作中，这类遗漏会立刻暴露：PR 里满屏红色未使用 import，CI 因 goimports -l 检查失败而阻断。
-
goimports是gofmt的超集，兼容全部功能，额外做 import 的增删、字母排序、标准库/第三方/本地包三段分组 - Go 官方工具链推荐用
goimports替代gofmt（尤其在 module 模式下） - VS Code 和 GoLand 都默认不启用
goimports，必须手动切换，否则「保存即格式化」形同虚设
GoLand 中正确启用 goimports 的关键步骤
Settings → Languages & Frameworks → Go → Formatting：
- ✅ 勾选 Run
goimports（不是gofmt，也不是「Use built-in formatter」） - ✅ 勾选 Reformat on save（位置在 Settings → Tools → Save Actions）
- ⚠️ 如果提示
Command not found：点右侧...按钮，手动指定路径——通常是$GOPATH/bin/goimports或$GOBIN/goimports，别选成gofmt或gopls - ⚠️ 关闭 Reformat on paste（Settings → Editor → General → Smart Keys）：否则粘贴代码后触发两次格式化，可能把多行参数挤成一行或吞掉空行
goimports 安装与路径验证必须做
终端执行以下命令确认可用：
go install golang.org/x/tools/cmd/goimports@latest
然后验证：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
which goimports
如果无输出或路径不对，说明没进 PATH。常见问题：
- Go 1.21+ 默认
GOBIN不再自动加入PATH，需手动追加：export PATH=$GOBIN:$PATH - 多版本 Go 共存时，
which go和which goimports可能指向不同版本，导致goimports解析go.mod失败 - 非 module 根目录下的文件，
goimports无法识别本地包路径，import 分组会错乱——确保你在 module 目录内打开项目
File Watchers 不是首选方案，容易和保存格式化冲突
虽然 Tools → File Watchers → + → go imports 能监听保存并运行，但它和「Save Actions」里的 Reformat on save 是两套机制，同时启用会导致重复格式化。表现是：
- 保存后 import 行被删了又加回来，或者顺序反复颠倒
- 某些嵌套结构（如 struct 字段列表）被意外折行或压成单行
- 修改配置后不生效，因为 File Watchers 缓存了旧的 Program 路径
除非你明确需要「仅对某类文件（如生成代码）单独格式化」，否则关掉 File Watchers 的 goimports 监听器，只依赖 Settings 里的原生集成。
最易被忽略的一点：改完设置后，goimports 不会立即生效于已打开的文件。必须关闭再重新打开该文件，或执行 File → Invalidate Caches and Restart → Just Restart，否则 IDE 仍按旧规则缓存解析结果。
