Go mod vendor 使用教程｜生成本地依赖目录方法

go mod vendor 命令用于将模块依赖复制到本地 vendor 目录，实现依赖本地化管理。首先需初始化项目并生成 go.mod 文件，通过 go mod tidy 确保依赖完整后执行 go mod vendor，该命令会根据 go.mod 和 go.sum 文件从缓存中复制依赖源码至 vendor 目录；构建时使用 go build -mod=vendor 可强制使用本地依赖，确保构建一致性；vendor 目录应提交至版本控制以共享环境，更新依赖时需重新运行 go mod tidy 与 go mod vendor；此方式提升构建可重复性，适用于对依赖严格管控的生产场景。

在 Go 项目开发中，go mod vendor 是一个非常实用的命令，用于将当前模块的所有依赖项复制到项目根目录下的 vendor 文件夹中。这种方式可以实现依赖的本地化管理，适用于离线构建、确保依赖一致性或满足某些 CI/CD 环境的要求。

启用 Go Modules 并初始化项目

在使用 go mod vendor 之前，确保项目已正确启用 Go Modules。如果项目还没有 go.mod 文件，需要先进行初始化：

• 进入项目根目录，运行：go mod init 项目名
• 添加依赖后，Go 会自动生成 go.mod 和 go.sum 文件

生成 vendor 目录

当 go.mod 中的依赖已经下载完成后（可通过 go mod tidy 自动补全缺失依赖），执行以下命令生成 vendor 目录：

该命令会：

• 读取 go.mod 中声明的依赖版本
• 从模块缓存中复制对应依赖的源码文件
• 将所有依赖代码放入项目根目录的 vendor/ 子目录中

使用 vendor 目录进行构建

生成 vendor 后，可以通过 -mod=vendor 参数让构建过程只使用本地依赖：

注意事项：

• 必须确保 go.mod 和 go.sum 已正确锁定依赖版本
• 如果后续修改了依赖（如升级包），需重新运行 go mod tidy 和 go mod vendor
• vendor 目录应提交到版本控制系统（如 Git），以便团队共享一致的依赖环境

清理或更新 vendor 目录

若要重新生成 vendor 目录，可先删除旧目录：

然后重新执行：

也可结合以下命令确保依赖整洁：

基本上就这些。通过 go mod vendor 可以有效管理项目的本地依赖，提升构建的可重复性和稳定性，尤其适合对依赖控制要求严格的生产环境。