在 Go 中，可通过创建独立的测试辅助包（如 testutil）封装通用的 setup/teardown 逻辑，并由多个业务包的测试文件导入复用，避免代码重复与维护冗余。

在 go 中，可通过创建独立的测试辅助包（如 `testutil`）封装通用的 setup/teardown 逻辑，并由多个业务包的测试文件导入复用，避免代码重复与维护冗余。

Go 的测试机制默认将 _test.go 文件限制在所属包内编译（即 foo/widget_test.go 只能访问 foo 包的标识符），因此无法直接将 setup/teardown 函数放在 foo 或 bar 包中供对方测试使用。解决方案是提取公共测试逻辑到一个专用的、可导出的辅助测试包中——例如命名为 testutil 或 internal/testutil（推荐置于 internal/ 下以防止外部模块意外依赖）。

该包应仅包含测试专用功能，不参与生产构建。典型结构如下：

myproject/
├── foo/
│   ├── widget.go
│   └── widget_test.go
├── bar/
│   ├── wingding.go
│   └── wingding_test.go
└── internal/
    └── testutil/
        ├── testutil.go
        └── testutil_test.go  // （可选）自身单元测试

internal/testutil/testutil.go 示例内容：

package testutil

import (
    "testing"
    "time"
)

// SetupDB 初始化测试数据库连接并返回清理函数
func SetupDB(t *testing.T) func() {
    t.Helper()
    // 模拟 DB 初始化
    t.Log("Setting up test database...")
    return func() {
        t.Log("Tearing down test database...")
        // 执行清理：关闭连接、清空临时表等
        time.Sleep(10 * time.Millisecond) // 占位逻辑
    }
}

// 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
}

随后在各测试文件中直接导入并使用：

// foo/widget_test.go
package foo

import (
    "testing"
    "myproject/internal/testutil" // 路径根据 module 名调整
)

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

    // ... your test logic
}

// bar/wingding_test.go
package bar

import (
    "testing"
    "myproject/internal/testutil"
)

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

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

✅ 关键注意事项：

• 辅助包路径建议使用 internal/ 前缀，确保仅项目内可引用，增强封装性；
• 所有导出函数应接收 *testing.T 参数，便于调用方使用 t.Helper() 和 t.Cleanup()；
• 避免在辅助包中引入生产代码依赖，保持其纯粹的测试职责；
• 若 setup 逻辑涉及复杂状态（如全局 mock），需注意并发安全——go test -race 下各测试函数默认并发执行，应避免共享可变状态，优先使用函数局部资源或同步机制。

通过这种模式，你不仅实现了跨包测试逻辑复用，还提升了测试代码的可维护性与一致性。