goland保存时自动格式化核心是配对gofmt与goimports路径并开启save actions开关：需手动安装goimports、在settings→tools→go tools中填入二者绝对路径、勾选“use goimports instead of gofmt”，再于save actions中启用reformat code和optimize imports，并将作用域限定为go文件。

GoLand 保存时自动格式化代码，核心不是装插件，而是配对 gofmt 和 goimports 路径，并打开 Save Actions 中的对应开关——漏掉任一环，都会导致“点了保存却没整理 import”或“整行缩进没变”。

确认 gofmt 和 goimports 已安装且可执行

IDE 不会帮你装这两个命令，只负责调用它们：

• 运行 which gofmt（macOS/Linux）或 where gofmt（Windows），确认路径存在；它通常随 Go 安装，比如 /usr/local/go/bin/gofmt
• goimports 不是默认自带的，必须手动安装：go install golang.org/x/tools/cmd/goimports@latest
• 安装失败？先执行 go env -w GOPROXY=https://goproxy.cn,direct 换国内镜像
• 装完再跑 which goimports，拿到绝对路径——后面配置 IDE 时直接粘贴，别手敲

在 Settings → Tools → Go Tools 中填准路径

GoLand 默认只从 $PATH 找 gofmt，但几乎找不到 goimports，所以必须手动指定：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 打开 Settings（Windows/Linux）或 Preferences（macOS）→ Tools → Go Tools
• gofmt path：填你刚查到的 gofmt 绝对路径；为空就填，别留空
• goimports path：必须填，且必须是你 which goimports 输出的完整路径，比如 /home/xxx/go/bin/goimports
• 勾选 Use goimports instead of gofmt：这是关键——不勾，保存时只格式化不修 import；勾了，才会删未用包、加缺失包、按分组排序

开启 Save Actions 并限定作用域

路径配对了，但开关没开，还是白搭；开了但作用域设错，可能误格式化 JSON 或 Shell 脚本：

• 进入 Settings → Tools → Save Actions
• 勾选 Reformat code 和 Optimize imports（后者依赖 goimports 路径）
• 点 Configure scope… → 把 All files 改成 Go files，避免对 .json 或 .sh 文件下手
• 留意 Only for changed lines：勾选后只动你改过的行，整文件风格可能不统一；团队协作建议不勾，整文件重排

注意 .editorconfig 会覆盖 IDE 设置

哪怕你在 IDE 里把 Tab size 设成 4、用空格缩进，只要项目根目录有 .editorconfig 且写了 indent_size=2，IDE 就会无视你的设置并灰掉相关选项：

• 检查项目根目录是否存在 .editorconfig；如有，打开看 indent_style、indent_size、tab_width 等项
• 修改 .editorconfig 后，已有文件不会自动同步——要对单个文件按 Ctrl+Alt+L 强制重排，或批量选中文件右键 → Reformat Code
• 如果想让新文件也遵循，确保 .editorconfig 的 [*.go] 段落明确写了 Go 相关规则

最容易被忽略的是 goimports 路径填错 + Use goimports instead of gofmt 没勾，这两项同时出问题，就会让你以为“自动格式化失效”，其实只是它压根没尝试修 import。配完务必用一个带未用包的 .go 文件测试保存动作。