go mod 依赖管理

什么是go mod

go mod 是从 Go 1.11 版本开始引入的。Go Modules 是 Go 语言官方提供的一个版本管理工具，旨在解决依赖管理和版本控制的问题。从 Go 1.11 开始，Go Modules 被作为实验性功能引入，到了 Go 1.13 版本，Go Modules 成为了官方推荐的依赖管理方式，并且默认开启。这意味着从 Go 1.13 开始，当你在一个没有 go.mod 文件的目录下运行 go build 或者 go run 等命令时，Go 会自动初始化一个模块。到了 Go 1.15，Go Modules 成为了默认的依赖管理方式，不再需要显式地启用。

go mod 是 Go 语言中用于管理模块（module）的命令集。它帮助开发者处理项目依赖，确保项目的可重复构建，并且可以轻松地与他人共享代码。以下是 go mod 命令的一些基本用法：

go mod 命令

初始化项目

如果你想要为你的项目创建一个新模块，可以在项目根目录下运行以下命令(或者使用idea自动初始化)：

go mod init

下载依赖

当你在项目中添加了新的 import 语句后，可以通过运行以下命令来下载这些依赖：

go mod download

更新依赖

要更新所有依赖到最新版本，或者指定更新某个特定的依赖，可以使用：

go mod tidy

这个命令会删除未使用的模块，并尝试解决缺失的模块。如果你想只更新特定的依赖包，你可以这样做：

go get -u [module_path]

检查依赖

为了检查你的 go.mod 文件是否有任何问题或过时的依赖，可以运行：

go mod verify

查看依赖树

如果你想查看项目的所有依赖关系，包括直接和间接依赖，可以使用：

go mod graph

替换依赖

有时候，你可能需要使用本地的一个依赖版本而不是远程仓库中的版本，这时可以使用替换功能：

go mod edit -replace=old_module_path=new_module_path

忽略某些依赖

如果你想要忽略某些依赖的更新，可以在 go.mod 文件中使用 exclude 指令：

exclude [module_path]

固定依赖版本

如果你想固定某个依赖的具体版本，可以在 go.mod 文件中直接指定版本号：

require [module_path] v1.2.3

go mod 代理

go mod 结构

Go mod

• 文件 : go.mod 和 go.sum
• 格式: 简单的文本文件，易于阅读和编辑。
• 内容 :
  • module 行定义模块的路径。
  • require 行列出直接依赖及其版本。
  • replace 和 exclude 行用于替换或排除特定依赖。
  • go.sum 文件记录所有依赖的校验和，确保依赖的一致性和安全性。

Maven

• 文件 : pom.xml
• 格式: XML 文件，结构较为复杂，但功能强大。
• 内容 :
  • <groupId>, <artifactId>, <version> 定义项目的基本信息。
  • <dependencies> 列出所有直接依赖及其版本。
  • <dependencyManagement> 用于管理传递依赖的版本。
  • <build> 配置构建过程，包括编译、测试、打包等。
  • <profiles> 用于定义不同的构建配置。

依赖解析

Go mod

• 直接依赖 : 使用 require 关键字声明。
• 传递依赖 : 自动解析并记录在 go.mod 文件中。
• 版本选择: 优先选择最新的次要版本或补丁版本，除非指定了具体版本。
• 锁定机制 : go.sum 文件确保依赖的一致性和安全性。

Maven

• 直接依赖 : 使用 <dependencies> 标签声明。
• 传递依赖 : 自动解析并记录在 pom.xml 文件中。
• 版本选择 : 可以通过 <dependencyManagement> 标签管理传递依赖的版本。
• 锁定机制 : 使用 mvn dependency:tree 命令查看依赖树，但没有像 go.sum 这样的文件来锁定所有依赖。

构建过程

Go mod

• 构建命令 : go build, go test, go run 等。
• 构建过程: 直接由 Go 编译器处理，简单高效。
• 插件系统: 有限，主要依赖于 Go 工具链本身的功能。

Maven

• 构建命令 : mvn clean install, mvn test, mvn package 等。
• 构建过程: 定义了多个生命周期阶段，每个阶段可以执行多个任务。
• 插件系统: 强大的插件系统，可以扩展构建过程，支持复杂的构建逻辑。

依赖缓存

Go mod

• 缓存 : 依赖文件默认存储在 $GOPATH/pkg/mod 目录下。
• 缓存管理 : 使用 go clean -modcache 命令清除缓存。

Maven

• 缓存 : 依赖文件默认存储在 ~/.m2/repository 目录下。
• 缓存管理 : 使用 mvn dependency:purge-local-repository 命令清除缓存。

版本控制

Go mod

• 版本格式 : 语义化版本（例如 v1.2.3）。
• 版本范围 : 支持版本范围（例如 ^1.2.3），但通常建议使用具体版本。
• 版本锁定 : go.sum 文件确保依赖的一致性。

Maven

• 版本格式 : 语义化版本（例如 1.2.3）。
• 版本范围 : 支持版本范围（例如 [1.2.3,1.3.0)）。
• 版本锁定 : 使用 mvn versions:lock-snapshots 命令锁定快照版本。

多模块项目

Go mod

• 多模块 : 一个项目可以包含多个模块，每个模块有自己的 go.mod 文件。
• 子模块 : 子模块可以独立管理依赖，但通常建议整个项目使用一个统一的 go.mod 文件。

Maven

• 多模块 : 一个项目可以包含多个子模块，每个子模块有自己的 pom.xml 文件。
• 聚合构建 : 使用父 pom.xml 文件聚合子模块，支持复杂的多模块项目结构。