Go语言测试之测试用例的排序（详解Go test中如何控制测试执行顺序）

为什么 Go 默认打乱测试顺序？

Go 的设计哲学强调可靠性和可重复性。如果测试之间存在隐式依赖（比如一个测试依赖另一个测试的副作用），那么这种测试本身就是脆弱的。因此，go test 工具默认启用 -shuffle=on（从 Go 1.17 开始）或通过内部机制对测试函数名进行哈希打乱，以暴露这类问题。

如何强制按顺序执行测试？

虽然不推荐依赖测试顺序，但如果你确实需要控制 Go test排序，有以下几种方法：

方法一：使用 -p 1 禁用并行

即使禁用并行，Go 仍可能打乱顺序。所以这不是根本解决方案。

方法二：显式指定测试函数前缀 + 数字编号

Go 按照测试函数名的字典序执行（在未打乱的情况下）。你可以这样命名：

func Test01_Init(t *testing.T) {    // 初始化逻辑}func Test02_CreateUser(t *testing.T) {    // 创建用户}func Test03_DeleteUser(t *testing.T) {    // 删除用户}

但这仍然不能保证顺序，因为 Go 可能启用 shuffle。

方法三：使用 -shuffle=off（Go 1.17+）

从 Go 1.17 开始，你可以通过命令行关闭 shuffle：

go test -shuffle=off ./...

此时，测试将按函数名的字典序执行。

方法四：在一个测试函数内按顺序调用子测试

这是最推荐的方式！使用 t.Run 显式控制子测试顺序：

func TestUserWorkflow(t *testing.T) {    t.Run("Init", func(t *testing.T) {        // 初始化    })    t.Run("CreateUser", func(t *testing.T) {        // 创建用户    })    t.Run("DeleteUser", func(t *testing.T) {        // 删除用户    })}

这种方式不仅保证了顺序，还清晰表达了测试之间的逻辑依赖，符合 Go单元测试 的最佳实践。

总结

- Go 默认打乱 测试用例排序 是为了防止隐式依赖。
- 不要依赖多个独立测试函数的执行顺序。
- 如需顺序，请使用 t.Run 在单个测试函数中组织子测试。
- 仅在调试时临时使用 -shuffle=off，不要用于 CI/CD 流程。

掌握这些技巧，你就能更好地编写健壮、可维护的 Go语言测试 代码！