go fmt -w ./ 不能处理 import，仅格式化代码；真正实现 import 自动增删/排序/分组及代码格式化的是 goimports -w ./，但需满足已安装、PATH 可见、存在 go.mod 三个前提。
go fmt -w ./ 不能自动处理 import，别误以为它能替代 goimports
命令行里执行 go fmt -w ./ 确实能格式化整个模块的代码，但它只做基础缩进、空格、换行等调整，**完全不碰 import 语句**——不会删未用包、不会按 std / third-party / local 分组、也不会补缺失的包。你手动加了个 fmt 包但忘了写 import？go fmt 视而不见。
-
go fmt是gofmt的封装，规则固定、零配置、不可扩展 - 真正要“一键整理依赖+格式化”，得用
goimports，不是go fmt - 如果项目没
go.mod，goimports -w ./会跳过 import 处理，甚至静默失败（不报错，也不改）
goimports -w ./ 才是实际可用的一键命令
它同时完成两件事：代码格式化 + import 自动增删/排序/分组。但必须满足三个前提，缺一不可：
- 已安装：
go install golang.org/x/tools/cmd/goimports@latest（Go 1.21+ 必须带@latest） -
goimports在 PATH 中：检查go env GOPATH，确认$GOPATH/bin（或$GOBIN）已加入系统 PATH - 当前目录是模块根目录：即存在
go.mod文件；若没有，先运行go mod init example.com/myproject
执行后，所有 .go 文件会被覆盖写入，import 块按标准顺序重排（std → third-party → local），未引用的包被删除，缺失的自动补上。
go mod tidy 不负责代码格式化，别混用
go mod tidy 只管依赖声明：清理 go.mod 里多余的 require，补全缺失的 indirect 依赖，同步 go.sum。它**完全不碰任何 .go 源文件内容**，也不会格式化代码或调整 import 语句。
立即学习“go语言免费学习笔记（深入）”；
- 想更新依赖清单 → 用
go mod tidy - 想让代码和 import 都干净 → 用
goimports -w ./ - 两者常一起用，但职责分明：
go mod tidy && goimports -w ./
CI/CD 中建议用 gofmt -l ./ 做格式一致性校验
在流水线里不推荐直接 -w 写回，而是用只检查不修改的模式，避免意外覆盖：
-
gofmt -l ./：列出所有未格式化的文件路径，有输出即失败（适合 check stage） -
goimports -l ./：同理，但要求go.mod存在且goimports可执行 - 注意：CI 环境 PATH 可能不含
$GOPATH/bin，需显式添加或用完整路径调用，例如$(go env GOPATH)/bin/goimports -l ./
本地开发用 goimports -w ./ 省事，CI 里只校验不修改——这是容易被忽略的边界差异。
