在Golang项目开发过程中，冗余依赖是很多开发者都会遇到的问题。随着项目功能不断迭代，部分之前引入的依赖可能不再被代码使用，但这些依赖依然会保留在go.mod和go.sum文件中，不仅占用项目空间，还会影响依赖下载和构建的效率。go mod tidy是Go官方提供的依赖管理工具，能够很好地解决这个问题。
go mod tidy的作用原理
go mod tidy命令会扫描项目中的所有Go源文件，分析代码中实际导入的包，然后对比go.mod文件中记录的依赖列表，执行两个核心操作：
- 删除go.mod中未被任何代码引用的冗余依赖条目，同时更新go.sum文件移除对应的哈希记录
- 补全go.mod中缺失的、代码实际需要的依赖条目，保证依赖列表的完整性
基本使用步骤
1. 确认项目已启用Go Modules
首先确保项目根目录下存在go.mod文件，如果还没有初始化Go Modules，可以先执行以下命令初始化：
# 初始化Go Modules，模块名替换为你的项目模块名 go mod init your_project_module_name
2. 执行清理命令
在项目根目录下打开终端，直接执行go mod tidy命令即可：
go mod tidy
命令执行完成后，会输出清理过程的提示信息，如果没有错误，说明冗余依赖已经被成功清理。
3. 验证清理结果
可以查看go.mod文件，确认之前的无用依赖已经被移除，同时检查项目是否能正常构建：
# 构建项目验证依赖是否正常 go build .
常见使用场景
场景一：日常迭代后清理依赖
每次完成功能开发、删除无用代码后，都可以执行一次go mod tidy，及时清理不再使用的依赖，避免冗余依赖堆积。
场景二：拉取新项目后初始化依赖
当拉取一个他人的Go项目时，如果项目的go.mod缺少必要依赖，执行go mod tidy可以自动补全所有需要的依赖，不需要手动逐个添加。
场景三：升级依赖版本后清理
当执行go get升级某个依赖的版本后，可能会有其他依赖随之变更，执行go mod tidy可以保证依赖列表和实际使用情况一致。
注意事项
- 执行go mod tidy前建议先提交当前代码到版本控制工具，避免误删必要依赖后无法恢复
- 如果项目中存在仅被测试代码使用的依赖，go mod tidy默认会保留这些依赖，不会将其判定为冗余依赖
- 如果执行命令时出现依赖拉取失败的问题，可以先检查网络环境，或者配置Go代理：
# 配置国内Go代理 go env -w GOPROXY=https://goproxy.cn,direct
示例演示
假设我们有一个go.mod文件，内容如下，其中github.com/gin-gonic/gin已经被代码移除不再使用：
module example_project
go 1.21
require (
github.com/gin-gonic/gin v1.9.1
github.com/go-sql-driver/mysql v1.7.1
)
执行go mod tidy后，go.mod会自动更新为：
module example_project go 1.21 require github.com/go-sql-driver/mysql v1.7.1
可以看到冗余的gin依赖已经被自动移除，同时go.sum中对应的记录也会被清理。
go_mod_tidyGolang依赖管理go mod修改时间：2026-06-29 07:06:22