Go go list -test -json 怎么查看测试变体和依赖包信息

用 go list -test -json . 可以查看当前包及测试构建相关的包对象；若还需要每个依赖包自己的信息，应增加 -deps。识别测试变体时保留完整的 ImportPath，结合 ForTest 判断用途，不要按目录路径把它们直接合并。

这里得到的是包元数据，不是测试执行事件。它适合解释测试代码由哪些包构成、哪些导入只在测试中出现，以及分析脚本为什么把同一目录识别成多个对象。它不能提供用例是否通过的结论。

官方地址：https://go.dev/cmd/go/#hdr-List_packages_or_modules

包名看似重复时，先确认是否启用了测试视图

假设一个依赖分析脚本原来只读取 go list -json，加上 -test 后突然出现更多对象，同一个目录也反复出现。先不要把这些记录判成重复数据：测试构建可能需要普通包、针对某个测试重新构造的包变体，以及生成的测试主包。

先在项目模块内限定到一个目标包，再扩大范围。下面两条命令分别回答“当前包的测试构建视图是什么”和“这些对象的依赖还有哪些元数据”。命令输出直接写文件，避免执行器的提示文本混入 JSON 数据通道。

# 在模块内查看当前包的测试相关包视图。
go list -test -json . > test-packages.json

# 需要依赖包各自的元数据时，显式增加 -deps。
go list -test -deps -json . > test-deps.json

阅读文件前还应保留命令退出码与标准错误。产生了部分 JSON 不代表全部包都成功加载。这里的命令和后文代码为原创使用示例，未实际执行，也没有给出虚构的终端截图或结果。

分开查看测试文件、测试导入与完整依赖

比如报告要展示“测试引入了什么”，应先看测试导入字段；如果还需要某个导入包的 Dir、Name 或 Module 等信息，再把展开后的包对象关联起来。把字段含义和输出对象范围分开，分析脚本才能避免漏项或误标。

同一个命令行范围内，依赖包可能同时被显式列出。DepOnly 描述的是它在本次 list 结果中是否仅作为依赖出现，因此这个字段需要结合命令参数解释，不能作为跨运行永久标签。

用 ImportPath 和 ForTest 判断测试变体

普通包的 ImportPath 通常就是导入路径；生成测试主包的标识带有 .test 后缀；为某个测试重新构造的包标识可能带空格和方括号中的测试主包名。ForTest 指明这个包变体服务于哪个被测包。

假设本文的示例模块叫 example.test/parcel，分析器就可能遇到普通导入路径、带 .test 的测试主包标识，以及带测试上下文后缀的变体标识。这个命名说明只用于理解规则，不承诺所有项目都会得到固定数量的对象；是否有同包测试、外部测试以及需要重新构造的依赖都会影响结果。

最常见的错误是只用 Dir 做字典键。普通包和测试变体可能共享源目录，但参与构建的文件或导入关系不同；后一个对象覆盖前一个对象后，脚本就会得出“生产包突然多了测试依赖”的结论。

另一个错误是为了美观裁掉 ImportPath 中的方括号部分。展示层可以另外保存友好名称，关系索引仍应保留完整标识。原始对象、显示名称和所属测试上下文各用独立字段保存，比反复从一段处理过的字符串猜测更可靠。

用连续解码读取包对象，保留错误信息

包信息输出是一串 JSON 对象，可能跨多行，并非一个顶层数组。不能把每个物理行都单独 Unmarshal，也不能把整个文件当成一个 packageInfo。下面的完整 Go 程序连续 Decode，只提取身份和加载错误相关字段，其他字段仍保留在原始文件中。

package main

import (
    "encoding/json"
    "errors"
    "fmt"
    "io"
    "os"
)

type loadError struct {
    Err string
}

type packageInfo struct {
    ImportPath string
    ForTest    string
    DepOnly    bool
    Incomplete bool
    Error      *loadError
    DepsErrors []loadError
}

func printPackages(r io.Reader, w io.Writer) error {
    dec := json.NewDecoder(r)
    for {
        var p packageInfo // 每次新建对象，避免缺省字段沿用旧值。
        err := dec.Decode(&p)
        if errors.Is(err, io.EOF) {
            return nil
        }
        if err != nil {
            return fmt.Errorf("解码包信息失败: %w", err)
        }
        // 保留完整 ImportPath，不删除测试变体的方括号后缀。
        if _, err := fmt.Fprintf(w, "%q ForTest=%q DepOnly=%t Incomplete=%t\n",
            p.ImportPath, p.ForTest, p.DepOnly, p.Incomplete); err != nil {
            return err
        }
        if p.Error != nil {
            if _, err := fmt.Fprintf(w, "  加载错误: %s\n", p.Error.Err); err != nil {
                return err
            }
        }
        for _, de := range p.DepsErrors {
            if _, err := fmt.Fprintf(w, "  依赖错误: %s\n", de.Err); err != nil {
                return err
            }
        }
    }
}

func main() {
    if err := printPackages(os.Stdin, os.Stdout); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}

可以将程序另存为 read_packages.go，把上面的 JSON 文件作为标准输入。示例使用带引号的路径展示方式，便于看清标识中的空格。它不会把 ForTest 为空的对象一律排除，因为普通包、测试主包与依赖对象都可能需要保留。

如果为了诊断包加载失败使用 go list -e -test -deps -json .，错误会进入 Error、DepsErrors 等字段。消费端需要展示这些错误，并谨慎对待不完整对象；不要因为 JSON 解码成功就把不完整包误记成“没有依赖”。

依赖仍然缺失时，回到加载范围和构建条件

先查输出范围：只加 -test 并不等于展开了所有依赖对象，需要逐包查看时增加 -deps。再查读取方式：如果脚本只 Decode 一次，后面的测试对象根本没有进入分析结果。最后才看索引是否把共享目录的对象覆盖了。

构建条件也会影响文件选择。操作系统、体系结构、构建标签和 cgo 环境不同，看到的测试文件和导入关系可能不同。对照两次结果时，记录同一目标包、工具链及构建条件；不要把跨环境差异直接归咎于 -test。

不要同时使用 -find 来期待完整测试依赖图。官方将 -find 定义为只识别目标包而不解析依赖，并限制它与 -deps、-test 等选项组合。发现脚本带有这类快捷选项时，先回到需要的加载范围再组织命令。

生成的测试文件路径可能来自缓存，也可能不以 .go 结尾。若工具需要显示文件来源，应按对应字段和路径含义处理，不能只凭扩展名把它们过滤掉。本文没有把这些缓存路径当成用户必须手工编辑的源文件。

把包信息接入工具前的检查清单

• 分析包构成使用 go list，判断用例结果另选测试执行入口。
• 想展开依赖对象就显式使用 -deps，区分它与 Deps 路径字段。
• 完整 ImportPath 保留在索引里，Dir 仅用于来源说明。
• ForTest 与 DepOnly 分别表示测试用途和本次加载身份。
• 逐对象 Decode，保留 Error、DepsErrors 与命令退出状态。
• 对照不同结果时固定包范围及构建条件。

同一目录出现多个对象一定是异常吗？

不是。测试变体可能与普通包共享目录。先比较完整 ImportPath、ForTest 和源文件信息，再决定展示层如何分组。

-test 会运行测试函数吗？

这个选项用于列出测试构建相关包信息，不是用例执行开关。包元数据中没有“该用例已经通过”的证据，不能把加载成功写成测试成功。

只关心一个包，还需要 ./... 吗？

不需要。当前包可用点号表示；先收窄到单包更容易理解结果。需要覆盖项目子包时再扩大模式，同时注意输出对象数和诊断范围随之增长。

参考：Go 官方 list 命令、包字段与测试变体说明。本文命令、分析器与项目示例均为原创。