Go 官方推荐将测试所需的静态文件统一存放于 testdata/ 目录中，该目录会被 go 命令自动忽略，既保证测试可复现，又避免污染构建和发布流程。
go 官方推荐将测试所需的静态文件统一存放于 `testdata/` 目录中，该目录会被 `go` 命令自动忽略，既保证测试可复现，又避免污染构建和发布流程。
在 Go 项目中进行涉及文件 I/O 的功能测试时，关键在于隔离性、可重现性与简洁性。你不应依赖全局路径或随意创建临时文件（如用 os.MkdirTemp 或 ioutil.TempDir），除非测试本身正是为了验证临时文件生命周期或并发写入行为；对于绝大多数读取配置、模板、JSON 示例或 fixture 数据的场景，最佳实践是使用专用的 testdata/ 目录。
✅ 正确做法：使用 testdata/ 目录
在项目根目录下创建名为 testdata/ 的文件夹（注意无下划线、全小写），并将所有测试所需静态文件放入其中：
myproject/
├── main.go
├── main_test.go
└── testdata/
├── config.json
├── sample_input.txt
└── template.html
在测试代码中，可通过 filepath.Join("testdata", "config.json") 构造路径。由于 Go 测试运行时工作目录默认为模块根目录（即 go test 所在目录），该路径可直接用于 os.Open 或 ioutil.ReadFile：
func TestLoadConfig(t *testing.T) {
data, err := os.ReadFile(filepath.Join("testdata", "config.json"))
if err != nil {
t.Fatal(err)
}
// ... 解析并断言逻辑
}
⚠️ 注意：testdata/ 是 Go 工具链的约定关键字——go list、go build 和 go test 均会默认跳过该目录，因此它不会被误打包进二进制或影响 go mod vendor，也无需额外 .gitignore 规则（但建议仍将其加入以明确意图）。
❌ 不推荐的做法
- 手动管理临时文件：每次测试前生成、测试后清理，易出错（如 panic 导致 defer 未执行）、降低可读性，且违背“测试应轻量、确定”的原则。
- 硬编码绝对路径或 ../testing/ 等相对路径：破坏可移植性，跨环境（CI/本地/IDE）易失败。
- 将测试文件混入 main/ 或 internal/ 包中：违反关注点分离，增加构建体积，且可能意外导出。
? 补充建议
- 若需模拟文件系统行为（如权限错误、缺失文件），优先使用 afero 或 memfs 等内存文件系统库，而非真实磁盘操作。
- 对于大型二进制测试数据（如 >1MB 的图片或归档），考虑使用 //go:embed（Go 1.16+）配合 embed.FS，实现零磁盘依赖的嵌入式测试资源。
遵循 testdata/ 约定，不仅符合 Go 社区共识，更能让你的测试更健壮、协作更顺畅、CI 更稳定。
