Go vendoring 机制通过将依赖复制到 vendor/ 目录实现隔离与可重现构建，Go 1.11+ 需用 -mod=vendor 标志或 GOFLAGS 启用，配合 go mod vendor 管理，vendor/ 应提交至 Git。
Go 的 vendoring 机制（从 Go 1.5 引入，Go 1.6 默认启用，Go 1.11+ 后被 go mod 取代但依然兼容）允许你将项目依赖的第三方包完整复制到项目目录下的 vendor/ 文件夹中，实现依赖隔离和构建可重现性。虽然现在主流使用 Go Modules，但在某些受限环境（如离线构建、旧版 Go、CI/CD 要求锁定全部依赖路径）中，vendoring 仍有实际价值。
确认 Go 版本与 vendor 模式是否启用
运行 go version 确保是 Go 1.5–1.10（原生 vendor 支持最稳定），或 Go 1.11+（需显式启用 vendor 模式）。Go 1.11+ 默认使用 modules，要启用 vendor 行为，需确保：
- 项目根目录下存在
go.mod文件（即使空文件也可） - 执行命令时加上
-mod=vendor标志，例如：go build -mod=vendor - 或设置环境变量：
GOFLAGS="-mod=vendor"（全局生效）
初始化并填充 vendor 目录
如果你用的是 Go Modules（推荐方式），可通过以下步骤生成 vendor 目录：
- 确保项目已初始化模块：
go mod init your-module-name - 运行
go mod vendor：该命令会读取go.mod和go.sum，将所有直接/间接依赖复制到vendor/下，并生成vendor/modules.txt（记录 vendor 内容来源） - 验证是否成功：
ls vendor/应看到按路径组织的依赖包（如github.com/sirupsen/logrus）
构建和测试时强制使用 vendor
仅把包放进 vendor/ 不代表编译器自动使用它。必须显式告知 Go 工具链优先从 vendor 加载：
立即学习“go语言免费学习笔记（深入）”；
- 构建：
go build -mod=vendor - 运行测试：
go test -mod=vendor ./... - 运行 vet/lint 等工具时也建议加
-mod=vendor，避免误用 GOPATH 中的版本
若省略 -mod=vendor，Go 仍会走 module 模式（从 $GOPATH/pkg/mod 或 proxy 下载），vendor/ 将被忽略。
维护 vendor 目录的常见操作
vendor 不是一次性操作，需随依赖变更同步更新：
- 添加新依赖后，先
go get xxx（会写入go.mod），再运行go mod vendor - 升级依赖：
go get xxx@v1.2.3→go mod vendor - 清理未使用的依赖：
go mod tidy（修正go.mod）→go mod vendor - 检查 vendor 是否与
go.mod一致：go mod vendor -v（显示差异）或go mod verify
注意：vendor/ 是可提交到 Git 的——它本质是你项目的一部分，应和源码一起版本化。
