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:

bash
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:

go
package main

import (
	"fmt"

	"rsc.io/quote"
)

func main() {
	// 运行时调用依赖中的函数,验证该模块确实进入了构建图。
	fmt.Println(quote.Go())
}

预期结果:源文件可以在当前模块中解析 rsc.io/quote;继续运行下方命令验证构建与执行结果。

运行程序:

bash
go run .

预期输出:

text
Don't communicate by sharing memory, share memory by communicating.

如果这一步能运行,说明模块版本已经进入构建依赖图,而不只是被写进某个文本文件。此时再整理一次,让 go.mod 根据真实导入关系标记直接与间接依赖:

bash
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 从模块图中移除该模块要求,必要时连带调整相关依赖

执行查询:

bash
go list -m rsc.io/quote

预期输出:

text
rsc.io/quote v1.5.2

团队项目优先提交 go.mod 与 go.sum,不要只在聊天里写“我本地已经升级”。版本变化应通过这两个文件进入代码审查。

看懂直接依赖与间接依赖

源码直接 import "rsc.io/quote",因此它属于直接依赖;rsc.io/quote 自己依赖的模块,则会作为间接依赖进入模块图。go.mod 中常见的 // indirect 就是在标记这类要求。

直接依赖与间接依赖的模块关系

要确认某个间接模块为什么存在,可以让 Go 解释依赖路径:

bash
go mod why -m rsc.io/sampler

预期输出会包含一条从当前模块中的包到 rsc.io/sampler 的导入路径;具体包名会随所选版本变化。若输出最后显示 (main module does not need module ...),说明当前源码和测试已经不再需要它,应继续检查是否可以整理掉。

移除依赖并整理模块

最稳妥的移除方式是先删掉源码中的对应 import 和调用,再运行 go mod tidy。把 main.go 改成只使用标准库:

go
package main

import "fmt"

func main() {
	// 只保留标准库,给 tidy 一个明确的删除条件。
	fmt.Println("no external dependency")
}

预期结果:这个文件不再引用任何第三方包,下一步整理模块时 rsc.io/quote 不应继续作为必需依赖保留。

然后整理模块:

bash
go mod tidy
go list -m all

预期输出:

text
example.com/deps-demo

此时 rsc.io/quote 以及只为它服务的传递依赖会从需要列表中移除。go mod tidy 还会补上源码或测试实际需要、但 go.mod 缺失的模块,因此它不是单纯的“删除命令”。

如果必须主动撤销某个模块要求,可运行 go get rsc.io/quote@none。但源码仍然导入该模块时,后续构建或 go mod tidy 会再次暴露依赖缺失;所以先改代码、再整理依赖,通常更容易审查和回滚。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 go get 管理依赖版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通