Go 官方推荐将测试所需的静态文件统一存放在 testdata/ 目录中，该目录被 go 工具自动忽略，既保证测试可重现，又避免污染构建和发布流程。
go 官方推荐将测试所需的静态文件统一存放在 `testdata/` 目录中，该目录被 `go` 工具自动忽略，既保证测试可重现，又避免污染构建和发布流程。
在 Go 项目中进行涉及文件 I/O 的单元测试时，关键在于隔离性、可重复性与简洁性。你不应依赖运行时动态生成临时文件（如用 os.MkdirTemp 或 ioutil.TempDir），除非测试目标本身就是文件系统行为（例如权限检查、并发写入等）；对于绝大多数场景——比如解析配置文件、读取模板或加载 JSON 数据——更优解是使用静态、版本可控的测试数据文件。
✅ 正确做法：使用 testdata/ 目录
Go 工具链（包括 go test、go build、go list 等）会自动忽略名为 testdata 的子目录（详见 go help packages）。这意味着：
- 文件不会被意外编译进二进制；
- 不会出现在 go list -f '{{.GoFiles}}' 输出中；
- 可安全提交至 Git，便于团队共享和 CI 复现。
? 目录结构示例：
myproject/
├── main.go
├── main_test.go
└── testdata/
├── config.json
├── template.html
└── sample.csv? 在测试中读取文件（推荐方式）：
func TestLoadConfig(t *testing.T) {
// 使用相对路径：testdata/ 是相对于当前测试文件所在包的根目录
data, err := os.ReadFile("testdata/config.json")
if err != nil {
t.Fatal("failed to read test file:", err)
}
var cfg Config
if err := json.Unmarshal(data, &cfg); err != nil {
t.Fatal("invalid config format:", err)
}
// ... 断言逻辑
}⚠️ 注意事项：
- 不要硬编码绝对路径（如 /tmp/testdata/ 或 ../testdata/），os.ReadFile("testdata/xxx") 会自动基于测试文件所在包的模块根路径解析；
- 若测试文件较大或需多次读取，可考虑在 TestMain 中预加载，或使用 io.ReadSeeker 复用；
- 避免在 testdata/ 中存放敏感信息（如密钥、令牌），因其通常会被提交至代码仓库；
- 如需模拟“不存在的文件”或“权限拒绝”等边界情况，此时才应使用 os.CreateTemp + os.Chmod 构造临时环境。
? 小技巧：用 embed 包（Go 1.16+）嵌入测试资源（适用于只读场景）
若希望完全避免文件 I/O 依赖，还可结合 //go:embed 将 testdata/ 内容编译进测试二进制：
import _ "embed"
//go:embed testdata/config.json
var configJSON []byte
func TestWithEmbed(t *testing.T) {
var cfg Config
if err := json.Unmarshal(configJSON, &cfg); err != nil {
t.Fatal(err)
}
// ...
}总之，testdata/ 是 Go 社区广泛采纳、工具链原生支持的标准实践——它轻量、可靠、无需额外依赖，是文件相关测试的首选方案。
