【Go】 Go Modules 常用指令一览

---

其实我早应该了解
你的温柔是一种慈悲
但是我怎么也学不会
如何能不被情网包围
其实我早应该告别
你的温柔和你的慈悲
但是我还深深的沉醉在
快乐痛苦的边缘
                     🎵 阿桑《温柔的慈悲》

---

• 常用操作
• 执行命令go mod init在当前目录下生成一个go.mod文件，执行这条命令时，当前目录不能存在go.mod文件
• 执行go mod tidy命令，它会添加缺失的模块以及移除不需要的模块。执行后会生成go.sum文件(模块下载条目)。
• 执行命令go mod verify来检查当前模块的依赖是否全部下载下来，是否下载下来被修改过。
• 执行命令go mod vendor生成vendor文件夹，该文件夹下将会放置你go.mod文件描述的依赖包
• 安装所有依赖包
  - go mod init name
  - go build ./…

Go 1.11 版本引入的 Go Modules 系统，为 Go 语言项目的依赖管理带来了革命性的改进。Go Modules 允许开发者更容易地管理项目的依赖关系，不再依赖于 GOPATH。在这篇博客中，我们将探讨 Go Modules 的一些常用指令，帮助你更有效地管理 Go 项目。

初始化一个新的模块

go mod init <module-name>

当你开始一个新项目时，使用 go mod init，后跟模块名（通常是代码库的路径），可以初始化一个新的模块。这会创建一个 go.mod 文件，记录你的项目依赖。

添加依赖项

当你导入一个包并运行 go build 或 go test 时，该依赖会自动被添加到 go.mod 文件中。如果你想显式地添加一个依赖项，可以使用 go get：

go get <package>@<version>

这不仅会下载依赖并将其添加到 go.mod，还可以指定获取特定的版本或者分支。

升级和降级依赖

要升级现有依赖项到最新版本，可以使用：

go get -u <package>

如果需要降级到更低的版本，也是使用 go get，但是指定需要的版本号：

go get <package>@<version>

移除不再使用的依赖

随着项目的发展，某些依赖可能不再需要。移除不再使用的依赖项非常简单：

go mod tidy

这个指令会移除 go.mod 文件中不再引用的依赖，并且更新 go.sum 文件。

检查依赖项

查看当前项目的所有依赖和它们的版本，可以使用：

go list -m all

查看依赖树

要查看哪些包依赖于特定的依赖项，可以使用：

go mod why -m <package>

这有助于理解依赖项之间的关系。

解决依赖冲突

当你的项目直接或间接依赖于多个版本的同一个包时，可以使用：

go mod graph

来可视化依赖关系，并手动编辑 go.mod文件来解决版本冲突。

项目发布和版本标签

当你准备发布项目的新版本时，你应该在版本控制中标记：

git tag v1.0.0
git push origin v1.0.0

这会帮助 Go Modules 系统理解版本的变化，并能够管理依赖的特定版本。

结论

Go Modules 的引入极大地简化了 Go 语言的依赖管理，使得版本控制和包管理变得更加清晰和简单。通过上面介绍的常用指令，你可以更好地控制你的项目依赖，确保你的项目结构清晰和模块化。随着 Go 社区对 Modules 的持续支持和改进，我们期待它在未来变得更加强大和便利