在 Go 单元测试中，若需依赖固定内容的本地文件（如配置、模板或测试数据），推荐将文件统一存放于名为 testdata 的子目录中——该目录被 Go 工具链自动忽略，语义清晰且符合社区约定。
在 go 单元测试中，若需依赖固定内容的本地文件（如配置、模板或测试数据），推荐将文件统一存放于名为 `testdata` 的子目录中——该目录被 go 工具链自动忽略，语义清晰且符合社区约定。
Go 官方工具链（如 go test、go build）会自动忽略名为 testdata 的目录（详见 go help packages），这意味着它不会被误认为是可导入的包，也不会影响模块构建或依赖分析，同时又便于测试代码通过相对路径安全访问。
✅ 正确用法示例：
项目结构如下：
myproject/
├── main.go
├── main_test.go
└── testdata/
├── config.json
├── sample.txt
└── templates/
└── email.tmpl
在 main_test.go 中，可直接使用 filepath.Join("testdata", "config.json") 构建路径：
func TestLoadConfig(t *testing.T) {
path := filepath.Join("testdata", "config.json")
data, err := os.ReadFile(path)
if err != nil {
t.Fatalf("failed to read test file: %v", err)
}
// ... assert parsed content
}
⚠️ 注意事项：
- 不要使用 ioutil.TempDir 或 os.CreateTemp 创建临时文件来存放固定测试数据——这会增加测试复杂度、降低可读性，且无法复现相同输入；临时文件更适合模拟写入行为或破坏性操作（如测试文件覆盖、并发写冲突等）。
- testdata 中的文件应视为只读测试资源，避免在测试中修改其内容（否则可能影响其他测试用例）。
- 路径拼接务必使用 filepath.Join 而非字符串拼接，以保证跨平台兼容性（Windows/Linux/macOS 路径分隔符不同）。
- 若测试需大量或二进制测试数据，可考虑在 testdata/ 下合理组织子目录，并在测试中通过 filepath.WalkDir 加载批量样本。
总之，testdata 是 Go 生态中被广泛采纳、工具原生支持、语义明确的标准方案——简洁、可靠、无需额外依赖，是处理静态测试文件的首选方式。
