goland保存时自动清除无用导入需启用actions on save中的optimize imports并确保goimports已安装、path配置正确、项目含go.mod且以模块根目录打开。
保存时自动运行外部工具，本质是启用 Actions on Save，不是 File Watchers
GoLand 2024.3+ 版本已将保存时自动化逻辑统一收口到 Tools → Actions on Save，File Watchers 方式被标记为 legacy，且默认不监听 .go 文件——即使你配了，大概率静默失效。这不是 bug，是 JetBrains 主动弃用该路径。
如果你在 Settings → Tools → File Watchers 里看到 go fmt 或 goimports 模板并成功触发过，那很可能是旧版本残留或巧合（比如手动勾选了“Trigger file watcher on external changes”）。当前稳定可靠的方式只有一条：走 Actions on Save。
- 打开
Settings → Tools → Actions on Save - 勾选
Optimize imports（删无用 import、分组排序）和Reformat code（执行 gofmt 级别格式化） - 务必勾选
Only for changed files，否则每次保存都扫整个模块，卡顿明显 - 不要填任何命令路径——GoLand 内部直接调用
goimports和gofmt，前提是它们已在PATH中可执行
goimports 必须装对、路径必须通、项目必须有 go.mod
Optimize imports 不是开关，它是个依赖链：缺任一环节，就彻底不干活，且 IDE 不报错、不提示、不弹窗——你只会发现“保存后 import 还在那儿”。
检查三件事：
- 终端执行
goimports -version，必须返回版本号；若报command not found，运行go install golang.org/x/tools/cmd/goimports@latest - 确认
$(go env GOPATH)/bin在$PATH里：echo $PATH | grep "$(go env GOPATH)/bin"，没输出就得补进~/.zshrc或~/.bash_profile并重载 shell - 项目根目录必须有
go.mod，且 GoLand 是以该目录为项目根打开的（右下角状态栏显示module: xxx）；没有go.mod时，goimports无法识别本地包，直接跳过所有操作
Before launch 里的 Run External Tool 是编译前用的，不是保存时用的
很多人混淆两个地方：Actions on Save 控制「保存文件」事件，Before launch（在 Run Configuration 的 Configuration 标签页下）控制「点击 ▶️ 运行/调试」事件。两者触发时机、用途、配置方式完全不同。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
例如你想每次 go run main.go 前自动跑 swag init，才去 Before launch → + → Run External Tool 配；但这个配置对 Ctrl+S 保存毫无影响。
-
Before launch任务失败（如swag init报错）会中断编译，适合强校验场景 - 它不支持内联脚本，只能调已定义的 External Tool 或已有 Run Configuration
- 环境变量（如
GOOS=linux）必须填在Environment variables字段，不能塞进参数栏 - 多个任务按列表顺序执行，不可并行
容易被忽略的细节：Optimize imports 和 Reformat code 是两件事，得一起开
只开 Reformat code，代码缩进、空行、括号风格会变，但 import 一行都不会动；只开 Optimize imports，import 会被删、重排、分组，但函数体内部格式不变。二者功能正交，缺一不可。
更隐蔽的是：它们共用同一套底层配置（比如 import 分组规则），但 UI 上完全不体现关联。如果你改过 Settings → Go → Imports 里的设置（如自定义 local prefix），只有 Optimize imports 生效，Reformat code 不读这些。
所以最终效果是否符合预期，得看三个地方是否对齐：终端里 goimports -w 的行为、IDE 的 Go → Imports 设置、以及 Actions on Save 里两个复选框是否都打了勾。
