在Golang的模块化开发中，go mod是官方推出的依赖管理工具，而go mod vendor作为其中的重要子命令，能够将项目所有依赖的源码复制到项目根目录下的vendor文件夹中，方便项目离线编译、依赖归档等场景使用。下面详细介绍go mod vendor的具体使用方法和实践要点。
go mod vendor基础使用步骤
1. 初始化go mod模块
如果项目还没有使用go mod管理依赖，首先需要初始化模块，执行以下命令，其中模块名可以自定义，通常是项目的仓库地址：
# 初始化go mod模块，模块名替换为实际的项目标识 go mod init example/project
2. 下载项目依赖
初始化完成后，执行以下命令会自动分析项目代码中的import语句，下载所有需要的依赖并记录到go.mod和go.sum文件中：
# 自动下载缺失的依赖 go mod tidy
3. 执行vendor打包命令
依赖下载完成后，执行go mod vendor命令即可将依赖复制到vendor目录：
# 打包所有依赖到vendor目录 go mod vendor
执行完成后，项目根目录会生成vendor文件夹，里面包含所有项目依赖的源码，同时会生成vendor/modules.txt文件，记录vendor目录中依赖的版本信息。
go mod vendor常用参数说明
go mod vendor支持部分可选参数，可根据实际需求调整打包行为，常用参数如下：
| 参数 | 作用说明 |
|---|---|
| -v | 输出被复制到vendor目录的依赖包信息，方便查看打包过程 |
| -e | 即使遇到错误也继续执行，不会因为单个依赖拉取失败就中断整个打包流程 |
例如需要查看打包过程时，可以执行以下命令：
# 带输出信息的vendor打包 go mod vendor -v
go mod vendor实践注意事项
vendor目录的提交规范
是否将vendor目录提交到代码仓库需要根据项目场景决定：如果是需要离线部署的项目，或者团队内依赖下载速度较慢，建议将vendor目录提交到仓库，这样其他开发者拉取代码后可以直接编译，不需要重新下载依赖；如果是开源项目或者依赖体积较大，也可以不提交vendor目录，仅保留go.mod和go.sum文件，其他开发者拉取后执行go mod download即可下载依赖。
编译时启用vendor依赖
项目包含vendor目录后，默认情况下go build等命令不会优先使用vendor中的依赖，需要添加-mod=vendor参数才会使用vendor目录中的依赖进行编译：
# 使用vendor目录中的依赖编译项目 go build -mod=vendor
依赖更新后的vendor同步
如果后续更新了项目依赖，比如升级了某个依赖的版本，需要先执行go mod tidy更新go.mod和go.sum，再重新执行go mod vendor更新vendor目录，保证vendor中的依赖和go.mod记录的一致：
# 更新依赖后重新打包vendor go mod tidy go mod vendor
常见问题解答
问：执行go mod vendor提示依赖找不到怎么办？
答：首先检查go.mod文件中是否记录了该依赖，如果没有可以手动执行go get 依赖地址@版本号添加依赖，再重新执行go mod vendor。如果是私有仓库的依赖，需要提前配置GOPRIVATE环境变量，避免依赖拉取失败。
问：vendor目录中的依赖可以手动修改吗？
答：不建议手动修改vendor目录中的依赖源码，因为后续执行go mod vendor会覆盖手动修改的内容，如果需要修改依赖逻辑，建议先fork依赖仓库，修改后引用自己的fork版本。
go_mod_vendorGolang依赖管理go_mod修改时间：2026-07-05 14:27:27