使用 go mod vendor 可将依赖复制到本地 vendor 目录，确保构建一致性。首先通过 go mod init 初始化项目，再用 go get 添加依赖，生成 go.mod 和 go.sum 文件。执行 go mod vendor 将所有依赖（含间接）下载并复制到 vendor/ 目录，生成 modules.txt 记录版本信息。构建时需加 -mod=vendor 标志，使编译器优先使用 vendor 中的依赖，避免从模块缓存读取。更新依赖时先用 go get 指定新版本，再重新运行 go mod vendor。建议提交 vendor 到版本控制以保证环境一致，避免手动修改 vendor 内容，定期用 go list -m -u all 检查更新，并结合 go mod tidy 清理无用依赖。在 CI/CD 或 Docker 构建中显式使用 -mod=vendor 可提升可移植性与可靠性。
在 Go 项目中使用 go mod vendor 管理第三方依赖是一种常见的生产级实践，尤其适用于需要离线构建、确保依赖一致性或审计依赖包的场景。它通过将模块依赖复制到本地
vendor/目录，实现对依赖的集中控制。
启用 Go Modules 并初始化项目
确保你的项目使用 Go Modules 管理依赖。如果你还没有
go.mod文件，可以在项目根目录执行：
go mod init your-project-name
之后添加所需的第三方包，例如：
go get github.com/gin-gonic/gin
Go 会自动更新
go.mod和
go.sum文件，记录依赖版本和校验信息。
立即学习“go语言免费学习笔记（深入）”；
拉取依赖到 vendor 目录
当所有依赖都写入
go.mod后，运行以下命令将它们下载到本地
vendor/目录：
go mod vendor
该命令会：
- 根据
go.mod
中声明的依赖（包括间接依赖）下载源码 - 将所有依赖文件复制到项目根目录下的
vendor/
文件夹 - 生成或更新
vendor/modules.txt
，记录每个依赖模块的版本信息
此后，构建时将优先使用
vendor/中的代码。
使用 vendor 构建和运行项目
要让 Go 编译器使用
vendor/目录中的依赖，需在构建时加上
-mod=vendor标志：
go build -mod=vendor go run -mod=vendor main.go
如果不加
-mod=vendor，Go 可能仍会从模块缓存（
$GOPATH/pkg/mod）读取依赖，从而绕过 vendor 目录。
建议在 CI/CD 脚本或部署流程中显式使用该标志，确保构建环境一致性。
更新和维护 vendor 依赖
当你需要升级某个依赖时，先修改
go.mod文件中的版本：
go get github.com/gin-gonic/gin@v1.9.1
然后重新运行：
go mod vendor
这会刷新
vendor/目录内容。建议定期检查依赖安全性和版本更新，可通过：
go list -m -u all
查看可升级的模块。
注意事项与最佳实践
-
提交 vendor 到版本控制：在大多数生产项目中，建议将
vendor/
目录提交到 Git，以保证任意环境都能复现构建。 -
避免手动修改 vendor 内容：所有变更应通过
go get
或go mod tidy
控制。 -
清理无用依赖：使用
go mod tidy
删除未使用的模块，再执行go mod vendor
更新 vendor 目录。 -
Docker 构建优化：可在多阶段构建中先
go mod download
，再go mod vendor
，提高缓存利用率。
基本上就这些。合理使用
go mod vendor能显著提升项目的可移植性和构建可靠性，特别适合团队协作和发布场景。
