goimports 默认不启用自动增删 import，需显式配置编辑器或命令行；它是gofmt超集，额外支持import排序与增删，但不处理点导入、忽略go:generate和条件编译依赖。
goimports 能自动增删 import 行，但默认不启用——必须显式配置编辑器或命令行参数，否则它只会格式化，不会动导入语句。
goimports -w 不生效？检查是否真在用 goimports
很多人执行 goimports -w main.go 后发现未使用的 import 没被删掉，或者新引入的类型没自动加 import。这不是 bug，而是你可能根本没在用 goimports，而是在用 gofmt 或编辑器默认的格式化工具。
- VS Code 默认用
gofmt，即使装了goimports也不自动调用；需手动设置："go.formatTool": "goimports" - GoLand 默认格式化工具是
gofmt，要改到 Settings → Go → Formatting → Format tool → 选goimports - 终端里确认当前用的是哪个工具：
go list -f '{{.Imports}}' main.go看原始 import 列表，再运行goimports -d main.go对比差异，才能验证是否真起作用
goimports 和 gofmt 的行为差异在哪
goimports 是 gofmt 的超集：它会做 gofmt 所有事（缩进、换行、括号），额外多两件事——按字母分组排序 import，并根据符号使用情况增删 import 行。
- 排序规则：
standard（标准库）→third-party（第三方）→local（本模块内），组间空一行 - 新增 import：当你写
jsoniter.Marshal()但没 import"github.com/json-iterator/go"，goimports -w会自动加上 - 删除 import：删掉所有对
"os"的引用后，goimports -w会把它从 import 块中移除；但若该包只用于init()（如import _ "net/http/pprof"），它会保留——因为goimports能识别空白导入意图 - 不处理点导入（
import . "math"）：它会跳过，也不报错；这类写法本身已被govet和golangci-lint标记为危险，建议直接删
CI/CD 中集成 goimports 的正确姿势
别在 CI 里用 goimports -w 直接改源码——这会让 PR diff 失去意义，且掩盖开发者本地未格式化的事实。应该只做校验。
立即学习“go语言免费学习笔记（深入）”；
- 检查是否已格式化：
goimports -d ./...，非零退出码表示存在未同步的 import 变更 - 搭配
git diff --exit-code使用，确保没有未提交的格式化变更 - 注意路径通配符：
./...匹配所有子目录，但.只匹配当前目录；漏掉...容易忽略internal/或cmd/下的文件 - 避免误伤生成代码：如果项目含
pb.go或bindata.go，应在goimports -d命令中排除，例如：goimports -d $(go list -f '{{.Dir}}' ./... | grep -v '/gen/')
真正容易被忽略的是：goimports 不解析 go:generate 注释里的依赖，也不会为 //go:build 条件编译块动态调整 import。如果你的文件靠构建标签切换行为，得自己确保各分支下 import 都完整——工具帮不了这个忙。
