Go vendor 未包含新增依赖的同步步骤

新增依赖写进 go.mod 后，vendor 目录不会因为文件保存就自动补齐。最稳妥的同步动作是：先确认代码确实导入了这个包，再在主模块根目录执行 go mod vendor，最后用 vendor/modules.txt 和 -mod=vendor 验证。若依赖只写在 go.mod、没有被主模块的构建或测试包引用，它不出现在 vendor 中也可能是正常结果。

一、先确认新增依赖进入了模块图

我处理这类问题时，第一步不会立即打开 vendor 目录找文件，而是先看依赖是否真正进入当前主模块。新增包通常需要同时满足两个条件：代码中存在有效导入，模块图中有对应模块版本。只改了一个未被使用的 require，并不能要求 vendor 保留该模块的全部内容。

# 在包含 go.mod 的主模块根目录执行，先确认模块选择结果
go list -m all

# 只有代码已使用新增包时，才把导入路径放进实际构建图
go list ./...

# 依赖整理后再查看变更，避免把手工改 vendor 当成同步
go mod tidy

go list -m all 看到的是模块版本选择结果，不能单独证明某个包已经复制到 vendor；还要结合代码导入和后面的 vendor 生成结果判断。若项目使用 go.work，先确认当前命令所在的模块与工作区关系，否则可能是在另一个主模块上执行。

二、用 go mod vendor 重新生成同步快照

确认模块图正确后，在主模块根目录重新生成目录。这个命令会根据主模块构建和测试所需的包重建 vendor，并更新 vendor/modules.txt。它不是向旧目录追加几个文件，所以把新依赖目录从别处复制过来并不能替代同步。

# 重新构建 vendor 快照，并打印纳入的模块与包名
go mod vendor -v

# 对照清单确认新增模块版本和包路径已经出现
grep -n "example.com/your-dependency" vendor/modules.txt

# 用 vendor 模式构建测试，直接验证当前清单是否可用
go test -mod=vendor ./...

上面的 example.com/your-dependency 只是占位符，实际排查时替换成真实模块路径。若 grep 找不到内容，先检查模块是否真的提供了当前导入包、是否有 replace 指向本地目录，以及命令是否在正确的主模块根目录执行。

三、用清单和构建结果定位“没有同步”的原因

在支持自动 vendor 的模块配置中，Go 可能在存在且一致的 vendor/modules.txt 时采用 vendor 模式；显式加上 -mod=vendor 可以把验证意图写清楚。同步完成后建议查看 git diff -- go.mod go.sum vendor/modules.txt，把清单变化作为提交的一部分，而不是只提交源码导入。

相关问题

只执行 go mod tidy，为什么 vendor 仍然没有新增包？

go mod tidy 主要整理模块需求和校验信息，不负责重新构建 vendor 目录；确认模块图后还要执行 go mod vendor。

可以直接把新依赖复制到 vendor 目录吗？

不建议。手工复制容易让目录和 vendor/modules.txt、模块版本选择脱节，应由 go mod vendor 根据主模块状态统一生成。

vendor 中没有未使用的依赖是否异常？

不一定。vendor 面向主模块构建和测试所需的包，未被当前包集合引用的模块可能不会被复制；先检查导入路径和构建约束。