goimports 比 go fmt 多一步导包管理，因它自动增删 import 并排序；需安装、配置 path 和编辑器格式化工具路径，否则静默失效。
Goimports 为什么比 go fmt 多一步导包管理
因为 go fmt 只格式化代码结构，不增删 import 语句；goimports 会自动添加缺失的包、删除未使用的包，还能按标准排序——这是它被选作保存时自动整理的核心原因。
常见错误现象：改完代码后运行报 undefined: xxx，但明明写了 fmt.Println，却忘了加 "fmt"；或者删掉某段逻辑后，"os" 还留在 import 列表里，CI 却卡在 go vet 的 unused import 检查上。
- 必须用
go install golang.org/x/tools/cmd/goimports@latest安装，旧版golang.org/x/tools/cmd/goimports（无@latest）可能不兼容 Go 1.21+ - 安装后检查是否生效：
goimports -v main.go应该输出重排后的代码，而不是报command not found - Windows 用户注意 PATH：如果用的是 Go 官方 MSI 安装包，默认
GOBIN是空的，go install会把二进制放到%USERPROFILE%\Go\bin，得手动加进系统 PATH
VS Code 中配置保存时自动运行 goimports
不是靠插件“启用格式化”开关，而是靠 settings.json 显式指定格式化工具路径和触发时机——否则即使装了 goimports，VS Code 默认仍调用 gofmt。
使用场景：你按下 Ctrl+S，希望立刻看到 import 被清理、函数参数对齐、括号换行统一，而不是再手动跑一遍命令。
- 打开 VS Code 设置（JSON 模式），确保有这两项：
"go.formatTool": "goimports""editor.formatOnSave": true - 如果项目启用了
go.work或多模块，加一句："go.useLanguageServer": true，否则goimports可能无法正确解析本地 module 路径 - 避免和
gopls冲突：不要同时设置"gopls": { "formatting": "goimports" }和"go.formatTool"，优先用后者，前者是旧配置方式，已过时
GoLand / IntelliJ 配置 goimports 为默认格式化器
IDEA 系生态不认 go.formatTool 这种配置，必须进 GUI 设置里关掉内置格式器、手动指定外部命令——漏掉任一环节都会导致保存时没反应。
常见错误现象：点了 “Reformat Code”，弹出对话框说 “No formatter available”，或 import 没变化，但代码缩进动了，说明只走了内置 gofmt，没走 goimports。
- 进入
Settings > Languages & Frameworks > Go > Formatting - 勾选
Use external formatter，路径填goimports（macOS/Linux）或goimports.exe（Windows） - 取消勾选
Run go fmt before external formatter——否则会先格式一次再导包，多此一举还可能冲突 - Mac 用户若用 Homebrew 安装 Go，
goimports默认在/opt/homebrew/bin/goimports，不能只写goimports，否则 IDE 找不到
保存钩子失效的三个典型原因
不是配置没写对，而是环境链路断在了更底层：PATH、权限、或 IDE 缓存。这些问题不会报错，只会静默跳过格式化。
性能影响很小：单文件 goimports 平均耗时 vendor 目录下打开文件，或 GOPATH 混乱，它可能卡住 2–3 秒才返回——这时 VS Code 会直接放弃调用。
-
which goimports在终端能输出路径，但在 IDE 里执行却提示 command not found → 检查 IDE 启动方式：从 dock 或开始菜单点开的 IDE 不继承 shell 的 PATH，需用code --no-sandbox或jetbrains-toolbox启动 - 保存后 import 没变，但控制台也没报错 → 打开 VS Code 的 Output 面板，选
Go标签页，看是否有Failed to format file with goimports类似日志 - 修改了
go.mod加新依赖，之后goimports就不识别新包 → 运行一次go mod tidy，否则goimports解析类型时找不到符号定义
最麻烦的其实是 GOPROXY 和私有模块：如果公司内网模块没配好代理，goimports 在补全 import 路径时会超时，然后干脆不处理整段 import —— 这个问题不会报错，只会让你觉得“它有时候灵有时候不灵”。
