Golang包管理详解：go mod与vendor使用指南

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 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 的依赖管理虽然看起来简单，但在实际项目中如果不注意版本控制和代理配置，还是容易踩坑。