go mod tidy是go官方唯一支持自动识别并移除未引用依赖的命令，它基于源码import语句与go.mod双向比对，仅删除既无直接import、也无间接依赖的模块，但无法处理空白导入、条件编译和运行时加载等隐式依赖。
go mod tidy 是唯一能自动删依赖的命令
GoLand 本身不提供“一键清理依赖”的独立功能，它只是调用 Go 命令行工具。真正起作用的是 go mod tidy —— 这是 Go 官方唯一支持自动识别并移除未引用依赖的机制。IDE 界面里点“Sync dependencies”或右键 go.mod 选“Reload module”，底层都是执行这个命令。
它删的是：既没出现在任何 .go 文件的 import 语句中，也没被其他已保留模块间接依赖的模块。比如你删了所有 import "github.com/urfave/cli/v2"，又没别的包依赖它，go mod tidy 就会把它从 go.mod 里彻底去掉。
- 必须在项目根目录（含
go.mod的目录）下执行，否则无效 - GoLand 默认不会自动运行它，得手动触发或配置为保存时运行（Settings → Go → Modules → Run
go mod tidyon save） - 如果项目含多个 module（如
cmd/下有独立go.mod），得分别进子目录执行
哪些依赖 go mod tidy 删不掉，但其实该删
空白导入、条件编译、运行时加载这三类，go mod tidy 完全看不见，也不会动它们：
-
import _ "github.com/lib/pq"：只要没被其他包依赖，且没注册init()副作用，go mod tidy会删；但如果它只靠_导入来激活驱动，删了就 panic -
//go:build integration下的import：当前构建标签不匹配时，go mod tidy当它不存在，可能误删 - 通过
reflect.ImportPath或配置文件字符串加载的包（如插件机制）：静态分析根本扫不到，go mod tidy必然保留
这类情况只能靠人工验证：全局搜索包路径，看是否只出现在 _ 导入或测试文件里；再用 go mod why -m github.com/xxx 确认它是否真被主模块需要。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
GoLand 里怎么安全验证删得对不对
别光看 go.mod 变短了就以为完事。GoLand 提供的构建和测试入口，要配合命令行交叉验证：
- 在 GoLand 里点 “Build”（不是 Run）—— 它等价于
go build ./...，能发现编译期缺失的依赖 - 右键项目 → “Run Tests” —— 测试文件可能引入独立依赖，
go mod tidy会处理，但得确认测试仍通过 - 打开 Terminal，执行
go list -m all | wc -l，对比 tidy 前后数字；再跑go mod graph | grep your-module-name看是否还有意外引用
特别注意：GoLand 的 “Build” 默认不包含 cmd/ 子目录下的二进制，得手动加 go build ./cmd/... 才算完整。
删完之后容易被忽略的残留点
go mod tidy 只改 go.mod 和 go.sum，不碰磁盘上已下载的模块缓存，也不清 vendor/ 目录：
- 旧版本模块仍留在
$GOPATH/pkg/mod里，占空间但不影响构建；要彻底清理，得在 Terminal 执行go clean -modcache - 如果项目用了
go mod vendor，go mod tidy不会同步删vendor/里的对应目录，得手动go mod vendor重生成 -
go.mod里残留的replace或exclude如果指向已被删模块，go mod tidy不会自动清理，得人工检查
最常被跳过的动作是：没验证跨平台构建（比如 GOOS=linux go build）和没跑集成测试——这两类依赖往往藏在条件编译或测试专属 import 里，go mod tidy 默认看不见。
