Go go mod tidy 怎样合并重复的 require 块

如果 go.mod 里散落着多个 require 块，先确认模块的 go 指令是 1.27 或更高，然后在模块根目录执行 go mod tidy。对满足条件的模块，Go 会把重复的依赖声明整理为直接依赖块和间接依赖块，必要时补齐缺失模块、删除未使用模块；这不是简单的文本合并，整理结果仍由实际导入、测试文件和构建标签决定。

先确认重复块与 go 指令版本

多个 require 块常见于手工添加依赖、解决 Git 合并冲突，或者项目经过多次 Go 工具链升级。先看清楚模块声明，避免在旧工具链上把“没有合并”误判为命令失效：

module example.com/report

go 1.27

require example.com/logkit v1.4.0

// 测试与构建工具使用的模块可以单独列出，便于审阅
require (
    example.com/testkit v0.8.0
    example.com/trace v0.3.1 // indirect
)

// 这里可能还残留来自旧合并的重复 require 块
require example.com/codec v1.2.0

重点不是先把块手工拼成一个，而是确认每个模块路径是否重复、行尾的 // indirect 是否有意义，以及块上方的注释到底描述哪组依赖。require 记录的是模块的最低版本要求，不能只按文本位置判断它是否为直接依赖。

用 go mod tidy 触发依赖整理

进入包含 go.mod 的项目根目录执行命令。它会扫描当前模块实际使用的包，并结合测试文件等构建条件更新依赖声明：

# 在模块根目录整理 go.mod 和 go.sum
go mod tidy

# 需要观察被移除的模块时，保留命令输出
go mod tidy -v

对 go 1.27 或更高的模块，重复的 require 块会被自动归并；官方行为是让文件最多保留一个直接依赖块和一个间接依赖块。命令还可能增加代码确实需要但文件中缺失的模块，或删除没有提供相关包的未使用模块，所以执行后出现多处差异并不代表命令只做了排版。

如果项目使用了特定构建标签、平台文件或测试依赖，整理结果还会受这些包是否属于模块可见代码的影响。不要只在开发机上执行后直接覆盖变更，应该把差异交给代码审查。

理解直接块、间接块与注释归属

整理后的文件通常类似下面的形态。示例只表达组织关系，版本号和模块路径应以项目自身依赖为准：

// 直接依赖：当前模块代码直接导入的模块
require (
    example.com/logkit v1.4.0
    example.com/codec v1.2.0
)

// 间接依赖：由依赖图中的其他模块带入
require (
    example.com/testkit v0.8.0
    example.com/trace v0.3.1 // indirect
)

Go 1.27 的整理规则会保留依赖相关的块注释；如果一段注释原本挂在同时含直接和间接依赖的混合块上，整理后可能被合并并放到新的直接依赖块附近。这个变化是注释归属的结构调整，不等于依赖被升级。

建议用三列清单复核：

处理 Go 版本和自动化流水线边界

这项自动合并行为受 go.mod 中的 go 指令影响。若模块声明的是 go 1.26 或更早版本，使用旧工具链时可能继续保留多个块；此时不要通过改文本或反复运行命令制造“看起来一致”的结果，先确认项目是否准备提升最低 Go 版本。

在 CI 中，可以把 go mod tidy 视为依赖同步步骤，再把文件差异交给审查。例如：

# 先同步依赖，再检查工作区是否留下未预期的模块文件变更
go mod tidy
git diff -- go.mod go.sum

# 由项目自己的测试命令决定最终检查范围
go test ./...

上面的检查重点是差异可解释，而不是要求每个项目都保持完全相同的依赖块形状。升级工具链、增加构建标签或调整测试代码，都可能让 tidy 重新计算依赖图。

常见问题

旧 Go 版本能不能只靠 go mod tidy 合并所有 require 块？

不能保证。重复块自动收敛是 Go 1.27 及以上、且模块 go 指令满足条件时的行为；旧项目应先评估工具链升级，再决定是否手工整理。

go mod tidy 为什么合并块后还修改了 go.sum？

因为它同步的是依赖图，不只是 go.mod 的文本结构。新增、删除或测试依赖变化都可能影响校验和，应该结合差异确认来源。

能不能手工把多个 require 块直接拼起来？

不建议把手工拼接当成依赖整理方案。更稳妥的做法是先确认 go 版本和注释归属，再运行 go mod tidy，最后审阅 go.mod 与 go.sum。