go mod vendor 默认不生效,需确保 GO111MODULE=on 且项目根目录存在 go.mod;它仅复制 go.mod 中 require 的依赖到 vendor/,构建时须显式启用 -mod=vendor 才使用 vendor 内容。

直接结论:用 go mod vendor 就行,但默认不生效——必须先确保 GO111MODULE=on 且项目有 go.mod,否则命令静默失败或复制空目录。
为什么 go mod vendor 没反应?
常见现象是执行后 vendor/ 目录不存在,或者只生成了空文件夹。根本原因不是命令错了,而是 Go 没进模块模式:
-
GO111MODULE环境变量未设为on(尤其在 GOPATH 项目里,默认可能是auto或off) - 项目根目录下没有
go.mod文件(go mod init没运行过) - 当前目录不是模块根目录(比如在子目录里执行,但
go.mod在上级)
验证方式:运行 go env GO111MODULE 和 go list -m,后者应输出模块路径而非 command-line-arguments。
go mod vendor 的实际行为和限制
它不会“下载新包”,只是把当前 go.mod 解析出的所有依赖(含间接依赖)复制到 vendor/,并生成 vendor/modules.txt 记录来源。关键点:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 只复制
require声明的依赖,不包含replace或exclude规则影响后的结果(replace的路径仍会复制目标模块内容) - 不处理本地 replace(如
replace example.com/a => ./local/a),这种路径不会被复制进vendor/,构建时仍需该本地路径存在 - 复制的是“模块级”内容,不是每个
import路径单独拉取——所以如果go.mod里只写了golang.org/x/net v0.14.0,哪怕代码只用了其中http2子包,整个x/net模块都会进vendor/
构建时如何真正使用 vendor?
光有 vendor/ 目录不够,Go 默认仍走 module proxy。必须显式启用 vendor 模式:
- 加环境变量:
GOFLAGS="-mod=vendor"(推荐,全局生效) - 或每次构建加参数:
go build -mod=vendor - 注意:
-mod=vendor会跳过go.mod中所有replace,包括指向本地路径的——这点极易踩坑 - 验证是否生效:构建时加
-x参数,看日志里compile是否从vendor/下路径读取文件(如vendor/golang.org/x/net/http2)
vendor 后还能改依赖吗?
能,但操作逻辑反直觉:
- 修改
go.mod(如go get foo@v1.2.3)后,vendor/不自动更新 - 必须再手动跑一次
go mod vendor才会同步 - 删掉
vendor/后直接go build是 OK 的(只要网络通),但加了-mod=vendor就会报错:找不到vendor/modules.txt - CI 场景建议固定两步:
go mod download→go mod vendor,避免vendor命令触发隐式下载(受 GOPROXY 影响)
最常被忽略的是 -mod=vendor 和 replace 的互斥性——一旦开了 vendor 模式,所有 replace 都失效,连本地开发调试都会断链。需要 vendor 又要本地替换,只能先 go mod edit -replace,再 go mod vendor,最后删掉那行 replace(否则构建报错)。

















