Go 1.26 testing.ArtifactDir 怎么留测试产物：-artifacts 与临时目录取舍

测试失败时，真正让人抓狂的往往不是红色的失败状态，而是现场文件已经随着测试结束一起消失。Go 1.26 的 testing.T、testing.B 和 testing.F 都提供了 ArtifactDir，解决的是“文件该写到哪里”这个具体问题，但它不会自动替你决定是否长期保留。

把调试文件写入 ArtifactDir；需要让本地或 CI 留住文件时，再配合 -artifacts，并用 -outputdir 指定输出基目录。没有 -artifacts 时，目录只是测试生命周期内的临时空间。

先把 ArtifactDir 的两种去向分开

先看 Go 1.26 的语义：testing.T、testing.B 和 testing.F 都可以调用 ArtifactDir。如果命令带了 -artifacts，返回目录位于输出目录下；如果没有这个参数，返回的是测试完成后会被清理的临时目录。

这里有一个容易混淆的点：-outputdir 不是“永久保存开关”，它只是指定输出基目录。真正决定测试产物是否留下的是 -artifacts。每个测试或子测试都有独立的 ArtifactDir，同一个测试里重复调用会得到同一个目录；子测试的产物也不会自动放进父测试的产物目录。

把这组关系压成两个静态边界来看：测试对象边界负责提供接口，文件系统边界负责决定目录生命周期，中间由 产物接口连接。

把测试写成稳定的产物出口

假设一个解析测试失败时需要留下服务响应，文件名可以稳定为 response.json，目录则交给测试框架分配。这样同一段代码既能在开发机运行，也能被带参数的 CI 命令接管。

func TestParseResponse(t *testing.T) {
    dir := t.ArtifactDir()
    path := filepath.Join(dir, "response.json")

    data := []byte(`{"status":"invalid","source":"fixture"}`)
    if err := os.WriteFile(path, data, 0o600); err != nil {
        t.Fatalf("write test artifact: %v", err)
    }
}

这里的关键不是文件内容，而是路径来源。不要把 /tmp/project-test、工作区绝对路径或某个开发者的桌面目录写进测试；这些路径在容器、并行测试和不同操作系统上都不稳定。文件写入失败也要让测试明确失败，否则日志显示通过，诊断文件却没有生成，排查会更慢。

如果测试拆成子测试，每个子测试的 ArtifactDir 都是自己的空间。文件名可以相同，但不能假设它们位于父测试目录的下一层。这个边界对并行子测试尤其重要：共享一个手写目录，反而容易互相覆盖。

用 -artifacts 和 -outputdir 留住失败现场

本地偶发排查可以先保留默认临时目录语义；需要把文件带出测试进程时，再使用：

go test -run TestParseResponse -artifacts -outputdir ./test-output .

-artifacts 打开后，第一次调用 ArtifactDir 会在测试日志中输出类似 === ARTIFACTS TestParseResponse /path/to/artifact/dir 的位置提示。这个日志是定位入口，目录本身才是要纳入归档的内容。-outputdir ./test-output 让这批产物有一个明确的输出基目录，便于后续收集。

因此不要只加 -outputdir 就期待文件留下来，也不要在测试代码里判断某个 CI 厂商的环境变量。测试代码只负责写入 ArtifactDir，命令层负责决定这次运行是否保存。

在 CI 中按保留策略验收目录

持续集成里可以把判断简化为一张清单：遇到失败诊断或需要下载的快照时启用 -artifacts；用 -outputdir 把输出根目录固定下来；归档时覆盖这个输出目录；普通成功测试不把产物目录当成下一次运行的输入。

这里的 命令参数边界与测试产物边界要分开验收。前者确认 go test、-artifacts、-outputdir 的组合，后者确认 ArtifactDir、测试包、失败日志 与 CI 工件 是否落在同一个可收集范围内。

最后做一次反向检查：把 -artifacts 去掉，测试仍应能完成，只是临时目录会在测试结束后消失；把输出根路径换到另一个工作目录，测试也不应因为硬编码路径而失败。能通过这两个检查，说明产物是调试辅助，而不是隐藏的业务依赖。

相关问题

重复调用 ArtifactDir 会得到不同目录吗？

在同一个测试或子测试中，重复调用返回同一个目录；不同测试和子测试拥有各自独立的目录。

只设置 -outputdir 能保留测试文件吗？

不能。要让 ArtifactDir 指向可留存的输出目录，还需要显式传入 -artifacts。

ArtifactDir 适合保存长期基准数据吗？

不适合。它服务于本次测试的输出与诊断；长期基准数据应放在明确管理的测试数据或制品存储中。