Go / 系统课时
用 go get 管理依赖版本
用 go get 管理依赖版本
这一课把第三方模块的添加、固定版本、升级、移除和清理串成一条可验证流程。完成后,你能从 go.mod 判断直接与间接依赖,并知道何时用 go get,何时用 go mod tidy。
学习目标
- 用
go get module@version添加或切换依赖版本。 - 用
go mod tidy清理不再被源码和测试需要的依赖。 - 从
go.mod与go mod why -m判断直接依赖和间接依赖。
建立可重复的模块环境
以下示例使用真实模块 rsc.io/quote。先在空目录创建模块,再把版本固定到 v1.5.2:
mkdir deps-demo
cd deps-demo
go mod init example.com/deps-demo
go get rsc.io/quote@v1.5.2预期结果:目录中出现 go.mod 和 go.sum;go.mod 记录 rsc.io/quote v1.5.2,同时还可能列出它需要的间接模块。go get 的下载提示会因本机缓存状态不同而不同。
把下面内容保存为 main.go:
package main
import (
"fmt"
"rsc.io/quote"
)
func main() {
// 运行时调用依赖中的函数,验证该模块确实进入了构建图。
fmt.Println(quote.Go())
}预期结果:源文件可以在当前模块中解析 rsc.io/quote;继续运行下方命令验证构建与执行结果。
运行程序:
go run .预期输出:
Don't communicate by sharing memory, share memory by communicating.如果这一步能运行,说明模块版本已经进入构建依赖图,而不只是被写进某个文本文件。此时再整理一次,让 go.mod 根据真实导入关系标记直接与间接依赖:
go mod tidy预期结果:rsc.io/quote 作为当前源码直接导入的模块保留;只通过它被需要的模块继续作为间接依赖存在。
固定、升级与查询版本
go get 的 @ 后缀决定版本选择。日常项目中最常用的是精确版本、latest 和 none:
| 目的 | 命令 | 作用 |
|---|---|---|
| 固定版本 | go get rsc.io/quote@v1.5.2 |
将模块选择到指定版本,并更新 go.mod、go.sum |
| 升到最新版本 | go get rsc.io/quote@latest |
选择代理可见的最新发布版本 |
| 查看当前版本 | go list -m rsc.io/quote |
只查询,不修改依赖 |
| 显式移除要求 | go get rsc.io/quote@none |
从模块图中移除该模块要求,必要时连带调整相关依赖 |
执行查询:
go list -m rsc.io/quote预期输出:
rsc.io/quote v1.5.2团队项目优先提交 go.mod 与 go.sum,不要只在聊天里写“我本地已经升级”。版本变化应通过这两个文件进入代码审查。
看懂直接依赖与间接依赖
源码直接 import "rsc.io/quote",因此它属于直接依赖;rsc.io/quote 自己依赖的模块,则会作为间接依赖进入模块图。go.mod 中常见的 // indirect 就是在标记这类要求。

要确认某个间接模块为什么存在,可以让 Go 解释依赖路径:
go mod why -m rsc.io/sampler预期输出会包含一条从当前模块中的包到 rsc.io/sampler 的导入路径;具体包名会随所选版本变化。若输出最后显示 (main module does not need module ...),说明当前源码和测试已经不再需要它,应继续检查是否可以整理掉。
移除依赖并整理模块
最稳妥的移除方式是先删掉源码中的对应 import 和调用,再运行 go mod tidy。把 main.go 改成只使用标准库:
package main
import "fmt"
func main() {
// 只保留标准库,给 tidy 一个明确的删除条件。
fmt.Println("no external dependency")
}预期结果:这个文件不再引用任何第三方包,下一步整理模块时 rsc.io/quote 不应继续作为必需依赖保留。
然后整理模块:
go mod tidy
go list -m all预期输出:
example.com/deps-demo此时 rsc.io/quote 以及只为它服务的传递依赖会从需要列表中移除。go mod tidy 还会补上源码或测试实际需要、但 go.mod 缺失的模块,因此它不是单纯的“删除命令”。
如果必须主动撤销某个模块要求,可运行 go get rsc.io/quote@none。但源码仍然导入该模块时,后续构建或 go mod tidy 会再次暴露依赖缺失;所以先改代码、再整理依赖,通常更容易审查和回滚。