Go中测试工具函数必须放在非_test.go的普通包（如testutil）中且首字母大写，因为_test.go文件仅参与当前包测试构建，不被导出，其他包无法访问其中任何标识符。
Go 里测试工具函数默认不能跨包复用，因为 *_test.go 文件中的代码不会被导出到其他包；真正能复用的，必须是普通（非测试）包里的导出函数。
为什么 testutil 包必须是非 _test.go 文件
Go 编译器对 _test.go 文件有特殊处理：它只参与当前包的测试构建，且其内容不参与普通构建过程。即使你写了 func NewMockDB() *sql.DB 并首字母大写，在 utils_test.go 里，其他包 import 后依然会报 undefined: utils.NewMockDB。
-
testutil/目录下所有文件必须是.go（不是_test.go） - 包名可以叫
testutil，但必须声明为package testutil - 函数名、类型、变量名需首字母大写（如
NewTempDir），否则无法被外部访问
如何组织和导入本地 testutil 包
假设项目结构如下：
myapp/
├── go.mod
├── main.go
└── testutil/
└── fs.go // package testutil
关键点在于导入路径必须从模块根开始：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
testutil/fs.go开头写package testutil -
main.go或其他包中写import "github.com/yourname/myapp/testutil"（模块路径 + 子目录） - 不要用相对路径如
import "./testutil"，这在 Go Modules 下无效
常见错误：undefined: testutil.SomeFunc
这个错误几乎总是由以下原因之一导致：
- 调用方没 import
testutil包（漏写 import 或 import 路径错） -
testutil包内函数名是小写（如newTempDir），不可导出 - 误把
testutil/foo_test.go当作可复用包——它只对本包测试可见 - 模块未初始化：
go mod init没运行，或go.mod中 module 名与 import 路径不一致
跨项目复用时用 Go Modules 发布
如果多个项目都要用同一套测试工具，别复制粘贴，直接发布为独立 module：
- 新建仓库
github.com/you/go-testutil，运行go mod init github.com/you/go-testutil - 其他项目里
import "github.com/you/go-testutil"即可 - 用
git tag v0.3.1版本化，避免依赖漂移 - 注意：不要在
go-testutil里 import 主项目代码，否则形成循环依赖
最易被忽略的一点：测试工具包不是“越通用越好”，而是要严格控制依赖范围——比如一个生成临时 SQLite DB 的函数，就不该引入 github.com/gin-gonic/gin；否则别人 import 你的 testutil 就被迫拉入整个 Web 框架。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
