Go / 系统课时
用 go get 增删依赖
用 go get 增删依赖
这一课解决一个很具体的问题:项目需要新增、升级或回退 Go 模块时,怎样让 go get 同时更新依赖声明和解析结果,并能确认 go.mod 到底发生了什么变化。
学习目标
- 掌握
go get添加、升级和降级模块依赖的基本用法 - 能通过
go.mod与命令结果确认版本是否真的发生变化 - 理解删除不再使用的依赖与单纯修改版本之间的区别
添加依赖
go get 最常见的用途是把一个模块加入当前主模块。版本号可以直接写在模块路径后面;不写版本时,命令会按当前模块解析规则选择版本。
下面在一个全新的项目中添加 github.com/google/uuid,固定到已经存在的 v1.6.0。
mkdir go-get-demo
cd go-get-demo
go mod init example.com/go-get-demo
go get github.com/google/uuid@v1.6.0
cat go.mod预期结果
module example.com/go-get-demo
go 1.x
require github.com/google/uuid v1.6.0其中 go 1.x 的具体版本取决于当前安装的 Go 工具链。真正需要关注的是 require 中出现了 github.com/google/uuid v1.6.0。
升级和降级
已经存在的依赖可以直接指定另一个版本。版本变化首先体现在 go.mod,最终构建时使用哪个版本还要结合整个依赖图解析。
继续在刚才的目录执行升级和降级:
go get github.com/google/uuid@v1.6.0
go get github.com/google/uuid@v1.5.0
grep 'github.com/google/uuid' go.mod预期结果
require github.com/google/uuid v1.5.0这里的关键不是把 go get 当成“修改文本”的工具,而是让 Go 重新计算模块图并更新模块需求。降级一个模块时,相关依赖也可能受到连带影响,因此不能只盯着一行版本号。
删除依赖
删除一个依赖通常分两步理解:先确认代码已经不再直接导入它,再用 go mod tidy 清理没有被模块图需要的依赖声明。与“把版本降下来”不同,删除关注的是依赖是否仍然被需要。
例如代码已经移除 github.com/google/uuid 的 import 后,在项目目录执行:
go mod tidy
grep 'github.com/google/uuid' go.mod || true预期结果
`text
没有输出表示这行依赖已经不再出现在 `go.mod` 中。若其他依赖间接需要该模块,清理后的结果仍可能保留它,因此应该以实际模块图为准。
## 看清 go get 做了什么
排查依赖变化时,建议把操作和验证连起来,而不是执行完命令就继续开发。最基本的检查顺序是查看 `go.mod`,必要时再查看完整模块列表和差异。
`bash
go list -m all
git diff -- go.mod go.sum预期结果
example.com/go-get-demo
github.com/google/uuid v1.5.0
diff -- .../go.mod .../go.mod
...go list -m all 展示当前构建上下文中的模块版本;git diff 则帮助你确认这次操作究竟改了哪些声明。go.sum 发生变化并不等于代码导入关系发生变化,它还可能只是模块下载或校验信息发生了更新。
实际工作中,使用 go get 修改依赖后,应把 go.mod、go.sum 和构建或测试结果一起检查。尤其是降级操作,不要只确认目标模块变低了,还要确认项目仍能通过原有验证。