在 Go 中，可通过创建独立的测试辅助包（如 testutil）来统一管理跨包的测试初始化与清理逻辑，避免代码重复，提升可维护性与一致性。

在 go 中，可通过创建独立的测试辅助包（如 `testutil`）来统一管理跨包的测试初始化与清理逻辑，避免代码重复，提升可维护性与一致性。

当多个包（如 foo 和 bar）需要共用测试前的资源准备（setup）和测试后的资源清理（teardown）逻辑时，直接复制粘贴到各自 *_test.go 文件中不仅违反 DRY 原则，还会导致后续维护困难。Go 的模块化设计鼓励将可复用的测试基础设施提取为专用包——推荐命名为 testutil（或 internal/testutil，若仅限当前模块内使用）。

✅ 最佳实践：创建 testutil 包
在项目根目录下新建 testutil/ 目录，并定义通用测试生命周期函数：

// testutil/setup.go
package testutil

import (
    "testing"
    "time"
)

// SetupDB 模拟数据库连接初始化（可根据实际替换为 SQL DB、Redis 等）
func SetupDB(t *testing.T) func() {
    t.Helper()
    t.Log("Setting up test database...")
    // 实际逻辑：创建测试数据库、填充 fixture、启动 mock server 等
    return func() {
        t.Log("Tearing down test database...")
        // 实际逻辑：关闭连接、清空临时数据、停止服务等
    }
}

// WithTempDir 提供临时目录并自动清理
func WithTempDir(t *testing.T) string {
    t.Helper()
    dir, err := os.MkdirTemp("", "test-*")
    if err != nil {
        t.Fatal("failed to create temp dir:", err)
    }
    t.Cleanup(func() { os.RemoveAll(dir) })
    return dir
}

⚠️ 关键注意事项：

• 将 testutil 放入 internal/testutil/ 可防止被外部模块意外导入（符合 Go 内部包规范）；
• 所有导出函数必须接收 *testing.T 参数，以支持 t.Helper() 和 t.Cleanup()；
• 避免在 testutil 中使用全局状态或单例，确保测试间隔离；
• 若 setup 涉及耗时操作（如启动容器），可结合 testify/suite 或自定义 TestSuite 进一步封装，但对多数场景，纯函数式 SetupXxx(t *testing.T) func() 已足够简洁可靠。

? 在各包测试中调用：

// foo/widget_test.go
package foo

import (
    "testing"
    "your-module/testutil" // 替换为实际模块路径
)

func TestWidget_Process(t *testing.T) {
    cleanup := testutil.SetupDB(t)
    defer cleanup()

    // your test logic...
}

// bar/wingding_test.go
package bar

import (
    "testing"
    "your-module/testutil"
)

func TestWingding_Render(t *testing.T) {
    cleanup := testutil.SetupDB(t)
    defer cleanup()

    tempDir := testutil.WithTempDir(t)
    // use tempDir...
}

? 总结： 跨包测试复用的核心是「职责分离」——业务逻辑归业务包，测试基础设施归专用测试工具包。testutil 不仅解决 setup/teardown 复用问题，还为未来集成测试、基准测试扩展提供了统一入口，是构建健壮 Go 测试体系的重要基石。