在 Go 单元测试中，若需读取固定内容的本地测试文件，应统一存放于名为 testdata 的子目录中——该目录被 Go 工具链自动忽略，既保持项目整洁，又确保测试可重现、可移植。
在 go 单元测试中，若需读取固定内容的本地测试文件，应统一存放于名为 `testdata` 的子目录中——该目录被 go 工具链自动忽略，既保持项目整洁，又确保测试可重现、可移植。
在 Go 项目中，为测试提供稳定、可复现的文件输入是常见需求（例如解析配置、读取模板或处理 CSV 数据）。此时，不推荐在测试中动态创建临时文件（如用 os.MkdirTemp 或 ioutil.TempDir），除非测试逻辑本身正要验证文件系统行为（如权限、并发写入等）；也不建议将测试文件散落在 testing/ 或 test_files/ 等自定义目录中——这类命名缺乏约定，易被误提交、误构建，且不被 Go 生态工具（如 go test、go list、代码覆盖率工具）识别为“纯测试资源”。
✅ 正确做法：使用标准约定的 testdata/ 目录
该目录需与 *_test.go 文件位于同一包路径下（通常与 main.go 或 pkg/ 同级），例如：
myproject/
├── main.go
├── main_test.go
└── testdata/
├── config.json
├── sample.csv
└── template.txtGo 工具链会自动忽略 testdata 目录（go help packages 明确说明：testdata is ignored by the go tool），因此它不会参与构建、不会被 go list 扫描，也不会出现在 go mod graph 中，但可通过标准 os.Open 或 embed.FS 安全访问。
? 示例：在测试中读取 testdata/config.json
func TestLoadConfig(t *testing.T) {
// 构造相对于当前测试文件的路径（Go 会自动定位到同包下的 testdata）
data, err := os.ReadFile("testdata/config.json")
if err != nil {
t.Fatalf("failed to read testdata/config.json: %v", err)
}
var cfg Config
if err := json.Unmarshal(data, &cfg); err != nil {
t.Fatalf("invalid config format: %v", err)
}
if cfg.Timeout != 30 {
t.Error("expected Timeout=30")
}
}⚠️ 注意事项：
- testdata 必须是小写，且不能是 test 或 tests（这些可能被误认为测试包）；
- 不要在 testdata 中放置 Go 源文件（.go），否则 go build 可能报错；
- 若需嵌入文件到二进制（如 CLI 工具自带模板），可结合 //go:embed testdata/* 与 embed.FS，提升分发可靠性；
- 对于需要修改文件状态的测试（如模拟写失败、文件锁），仍应使用 os.MkdirTemp 创建隔离临时目录，并在 t.Cleanup 中清理。
总之，testdata/ 是 Go 社区广泛采纳、工具链原生支持的标准方案——简洁、可靠、无侵入。坚持这一约定，能让测试更清晰、协作更高效、CI 更稳定。
