goland默认用gofmt，必须手动切换为goimports才能自动增删/分组/排序import；需在settings→languages & frameworks→go→formatting中勾选“run goimports”并指定正确路径。
GoLand 用的是 gofmt 还是 goimports？先确认工具链
GoLand 默认格式化行为取决于你是否显式配置了 goimports。它不自动启用 goimports，哪怕你本地装了——IDE 仍可能只调用 gofmt，导致 import 不整理、分组乱、冗余包残留。这不是 bug，是默认策略。
检查路径：Settings → Tools → File Watchers，看是否有 goimports 监听器；或者进 Settings → Languages & Frameworks → Go → Formatting，确认 “Use” 下拉框选的是 goimports 而非 gofmt 或 gofumpt。
- 如果选的是
gofmt：它不管 import，团队看到的 import 块永远不一致 - 如果选的是
goimports：确保已安装且可执行——终端跑goimports -v应有输出 - 如果选的是
gofumpt：它比goimports更激进（比如强制空行、函数括号换行），但需团队共识，否则格式 diff 会频繁飘
保存时自动格式化没生效？查三个隔离点
“点了保存，代码没动”常见于三类环境隔离：
-
PATH隔离：GoLand 启动方式影响它读取的 shell 环境变量。从桌面图标启动时，它常拿不到你终端里go install写入的goimports路径。解决方法：用终端启动 GoLand（goland .），或在 Settings → Go → GOROOT 手动指定 Go 安装路径，再确认goimports在该GOROOT/bin或$GOPATH/bin下 - 模块上下文缺失：GoLand 在非模块根目录（即没有
go.mod的文件夹）打开单个.go文件时，可能降级为gofmt模式。验证方法：在项目根目录打开任意.go文件，再试保存 - 文件被排除：检查 Settings → Editor → Code Style → Go → Formatter 中 “Exclude from formatting” 是否误加了
*.go或特定路径模式
.editorconfig 对 Go 文件基本没用，别白配
Go 的缩进、换行、空格规则由 go fmt 或 goimports 硬编码决定，.editorconfig 里的 indent_style、tab_width 等设置在保存时会被覆盖。唯一有效的是告诉编辑器“这是 Go 文件”，避免误套 JS 规则。
保留最小配置即可：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
[*.go] end_of_line = lf insert_final_newline = true
其他字段如 indent_style 写了也无效——Go 格式器只用 tab 缩进，且 tab 显示宽度由编辑器 UI 控制（Settings → Editor → Font → Size），和格式化逻辑无关。
CI 检查失败但本地没报错？统一用 goimports -l
团队 CI 报 goimports -l . 有差异，但你在本地保存后 git status 干净，大概率是本地和 CI 调用的工具版本或参数不一致：
- CI 用的是
goimports -l ./，而你本地用的是go fmt -w——二者行为不同，go fmt不处理 import - 本地装的是旧版
goimports（比如 Go 1.20 编译），CI 用的是 Go 1.22+ 新版，对泛型、嵌套结构体的格式化有细微差别 - CI 运行路径不是模块根目录，
goimports -l扫不到子模块，漏检
统一做法：所有环境都用 goimports -l ./ 检查，且确保 CI 和本地用同一 Go 版本（go version 输出一致）。临时验证命令：git ls-files '*.go' | xargs goimports -l，比 goimports -l ./ 更可靠。
最易被忽略的点：团队协作中，格式化工具链的一致性比 IDE 设置更重要。哪怕 GoLand 配得再细，只要 CI 用的是另一套工具或版本，就会反复出现“我本地没问题，CI 过不了”的情况。
