go mod 是 go 官方推荐的模块管理工具,通过 go.mod 文件记录依赖关系,解决 gopath 模式下的依赖混乱问题;基本用法包括初始化模块(go mod init)、自动下载依赖(go build/run)、手动添加依赖(go get)、整理依赖(go mod tidy);其优势在于简洁、官方支持、跨项目共享依赖;vendor 目录是 go 1.5 引入的本地依赖存放方式,将依赖复制到项目内的 vendor 文件夹中,确保构建一致性与隔离性;生成 vendor 的命令为 go mod vendor,适合内网开发和严格控制版本的场景;两者区别在于 go mod 更轻便现代,依赖统一缓存;vendor 更保守安全,依赖打包进项目;可同时使用:日常开发用 go mod,发布前生成 vendor 提交;建议从 go mod 开始,稳定后启用 vendor;其他注意事项包括配置代理(goproxy)、保留 go.sum 文件、vendor 默认不包含测试依赖。

Golang 的包管理机制在 1.11 版本引入了
go mod,随后又保留了传统的
vendor目录方式。两者各有适用场景,理解它们的使用方法和区别,能帮助我们更好地管理项目依赖。

go mod 是什么?怎么用?
go mod是 Go 官方推荐的模块管理工具,它通过
go.mod文件记录项目的依赖关系,解决了过去 GOPATH 模式下依赖混乱的问题。
基本使用流程:
立即学习“go语言免费学习笔记(深入)”;

- 初始化模块:
go mod init your_module_name
- 自动下载依赖:当你在代码中引用外部包时,执行
go build
或go run
会自动下载并记录到go.mod
- 手动添加依赖:
go get some/module@version
- 整理依赖:
go mod tidy
会清理未使用的依赖,并补全缺失的
它的优势在于简洁、官方支持、跨项目共享依赖。比如你开发多个项目,都用到了
github.com/gin-gonic/gin,
go mod不需要重复下载,只需缓存一次。
vendor 目录是干什么的?
vendor是 Go 1.5 引入的一个本地依赖存放目录,主要用于将所有依赖复制到项目内部的
vendor/文件夹中。这样做的好处是:

- 项目构建完全隔离于网络环境
- 可以确保构建时依赖版本一致,避免远程依赖被修改或删除导致构建失败
你可以通过以下命令生成 vendor:
go mod vendor
这会在项目根目录下生成一个
vendor文件夹,里面包含了当前项目所需的所有第三方依赖代码。
适合场景:
- 公司内网开发,无法访问外网
- 需要严格控制依赖版本,防止外部包更新影响项目稳定性
go mod 和 vendor 的区别与选择
简单来说:
go mod
更现代、轻便,依赖统一缓存,不需要拷贝进项目vendor
更保守、安全,把所有依赖打包进项目,适合对依赖版本要求极高的生产环境
你可以同时使用两者:日常开发用
go mod,发布前生成
vendor提交到 Git 中。这样既方便协作,又保证部署一致性。
如果你不确定选哪个,可以先从
go mod开始,等项目稳定后再决定是否启用
vendor。
实际使用中的一些小细节
-
代理设置很重要:国内访问某些源(如 golang.org/x)可能较慢,可以通过配置
GOPROXY
来加速:GOPROXY=https://goproxy.cn,direct
- go.sum 文件不要删:这个文件记录了每个依赖的具体哈希值,用于验证完整性。如果改动依赖但没更新它,可能会出错。
-
vendor 不包含测试依赖:默认情况下,
go mod vendor
不会把测试用的依赖也带进来,如果你希望带上,加-copyto=vendor
参数试试。
基本上就这些。Go 的依赖管理虽然看起来简单,但在实际项目中如果不注意版本控制和代理配置,还是容易踩坑。










