Go work sync 为什么没有更新 go.sum

如果执行 go work sync 后某个模块的 go.sum 没有变化，通常是正常结果，不代表命令失效。这个命令同步的是 workspace 的构建列表到各个模块的 go.mod；workspace 额外需要、但模块集合中还没有的校验记录，则由 go.work.sum 保存。

官方资料：https://go.dev/ref/mod

因此，先看命令是否改变了相关 go.mod，再判断是否出现新的工作区级哈希。不要把“没有改写 go.sum”当成这条命令的失败条件。

先看清 go work sync 到底同步什么

把几个文件的职责分开，现象就容易解释：

• go.work 描述当前 workspace 包含哪些本地模块。
• workspace build list 是参与构建的依赖版本集合，由最小版本选择（MVS）计算。
• go work sync 把这个版本集合同步回 use 指定模块的 go.mod。
• 每个模块自己的 go.sum 保存该模块依赖的校验哈希，不是 workspace build list 的镜像。

官方文档明确说明，go work sync 会把构建列表中的版本写回 workspace 中各模块的 go.mod，而不是承诺每次都修改 go.sum。如果当前构建列表与模块要求已经一致，go.mod 和 go.sum 都可能保持不变。

go.sum 没变时该看 go.work.sum

go.sum 和 go.work.sum 都记录校验信息，但归属不同。go.sum 位于模块根目录，记录该模块直接或间接依赖的哈希；go.work.sum 用来保存 workspace 使用、但不在 workspace 各模块现有 go.sum 集合中的哈希。

这会产生三种常见观察结果：

用三个命令判断是不是看错了工作区

当结果和预期不一致，先确认命令实际使用的 workspace。尤其要注意 GOWORK=off 会关闭 workspace 模式；没有显式设置时，Go 会从当前目录及父目录寻找 go.work。

# 查看当前 go 命令实际加载的工作区；为空表示没有启用 workspace
go env GOWORK

# 查看 go.work 的 use 与 replace 结构，确认模块路径是否在预期范围
go work edit -json

# 只关注同步命令带来的文件差异，不把“没有差异”误认为错误
git diff -- go.mod go.sum go.work go.work.sum

其中，go env GOWORK 是最直接的上下文指标。如果它为空，当前命令就不是在目标 workspace 中运行；如果设置为 off，即使上级目录存在 go.work，也不会按 workspace 方式计算。

确实要更新模块 go.sum，使用 go mod tidy

如果目标是让某个模块的 go.sum 与该模块源码和依赖声明一致，应进入该模块目录执行 go mod tidy。它负责补齐缺少的依赖要求和校验记录，同时删除不再需要的条目；这和把 workspace build list 同步回多个模块是两件事。

# 进入真正拥有 go.mod 的模块目录
cd ./service

# 让当前模块的依赖声明与源码使用情况保持一致
go mod tidy

# 回到 workspace 根目录，分别查看模块级和工作区级文件
cd ..
git diff -- service/go.mod service/go.sum go.work.sum

不要为了让 go.sum 产生变化而手工删除哈希行，也不要把 go.work.sum 当成某个模块的 go.sum 替代品。是否有改动，取决于当前源码、模块图、已有校验记录和 workspace 上下文。

常见问题

go work sync 会自动把所有模块的 go.sum 合并吗？

不会。它计算 workspace build list，并把相关版本同步到 use 指定模块的 go.mod；模块级 go.sum 仍按各模块的依赖校验职责维护，workspace 额外哈希由 go.work.sum 补充。

没有任何文件变化是不是命令没有执行？

不一定。只要当前 workspace、构建列表和已有记录已经一致，就可能没有可写入的差异。先用 go env GOWORK 确认上下文，再用 git diff -- go.mod go.sum go.work.sum 看实际结果。

记住这一条即可：go work sync 关注 workspace 版本集合与各模块 go.mod 的一致性；go mod tidy 关注单个模块的依赖声明与 go.sum。两者目标不同，所以 go.sum 不变本身并不是异常。