使用go mod vendor可将依赖复制到本地vendor目录，适用于离线构建和依赖锁定。首先在项目根目录执行go mod init初始化模块，确保不在GOPATH内；通过import引入如"github.com/gin-gonic/gin"等包后，运行go mod tidy自动下载并整理依赖；接着执行go mod vendor生成vendor/目录及modules.txt文件；构建时需加-mod=vendor参数，如go build -mod=vendor以强制使用本地依赖；更新依赖时先用go get指定版本，再依次执行tidy和vendor命令；无需vendor时可直接删除该目录，不影响模块机制；常见注意事项包括：确保网络通畅、建议提交vendor至Git以保障一致性、支持交叉编译且不包含测试文件，完整流程提升CI/CD与私有部署可靠性。
Go 模块（go mod）从 Go 1.11 引入后，逐步取代了旧的 GOPATH 和 vendor 管理方式。虽然现在主流是使用模块自动管理依赖，但在某些场景下——比如离线构建、确保依赖一致性或发布时锁定代码——使用 go mod vendor 将依赖复制到本地 vendor/ 目录仍然非常有用。
启用 Go Module 并初始化项目
在使用 vendor 功能前，需确保项目已正确启用 Go Module。
注意：不要在 GOPATH 路径内初始化模块，否则可能无法正常工作。- 进入项目根目录，运行：
go mod init 项目名 - 例如：
go mod init myproject - 执行后会生成
go.mod文件，用于记录模块名和依赖信息
添加并下载依赖
当你在代码中 import 第三方包时，Go 工具链会自动记录依赖。
- 编写代码并引入外部包，如：
import "github.com/gin-gonic/gin" - 运行命令拉取依赖：
go mod tidy - 该命令会自动分析 import 并补全缺失的依赖，同时移除未使用的
生成 vendor 目录
一旦依赖被正确写入 go.mod 和 go.sum，就可以将所有依赖导出到本地 vendor 目录。
立即学习“go语言免费学习笔记（深入）”；
- 执行命令：
go mod vendor - 成功后会在项目根目录生成
vendor/文件夹，包含所有依赖源码 - 同时生成
vendor/modules.txt，记录 vendored 的模块列表
使用 vendor 构建和运行程序
要强制 Go 编译器只使用 vendor 中的依赖，需加上 -mod=vendor 参数。
- 构建项目：
go build -mod=vendor - 运行项目：
go run -mod=vendor main.go - 测试项目：
go test -mod=vendor ./...
-mod=vendor，Go 仍可能从缓存（$GOPATH/pkg/mod）读取依赖。只有显式指定才会强制使用 vendor。
更新依赖并重新生成 vendor
当需要升级某个依赖版本时：
- 更新
go.mod中的版本：
go get github.com/gin-gonic/gin@v1.9.1 - 重新整理依赖：
go mod tidy - 重新生成 vendor 目录：
go mod vendor
删除 vendor 目录
如果不再需要 vendor，可直接删除目录，不影响模块机制。
- 删除命令：
rm -rf vendor - 后续构建时将恢复从模块缓存加载依赖
常见问题与注意事项
- go mod vendor 失败？ 检查网络或代理设置，确保依赖能正常下载
- vendor 目录应提交到 Git 吗？ 可选。若需离线构建或严格锁定依赖，建议提交
- 交叉编译是否支持 vendor？ 支持，只要 vendor 完整，可离线交叉编译
- vendor 不包含测试文件：这是正常行为，vendor 仅包含被依赖的源码
