go-test-report 跑不起来是因为它不是官方工具，需手动安装：go install github.com/vakenbolt/go-test-report@latest，并确保$gobin或$gopath/bin在$path中。
go-test-report 为什么跑不起来？
它不是 Go 官方工具，也不是 go test 的内置子命令，本质是个独立二进制，需要手动安装。很多人执行 go-test-report 直接报 command not found，就是卡在这步。
- 必须用
go install github.com/vakenbolt/go-test-report@latest安装（注意不是go get） - 安装后二进制默认落在
$GOBIN或$GOPATH/bin，确保该路径在$PATH中 - 别试图用
go run启动源码——它依赖编译时嵌入的前端资源，go run会失败
测试数据怎么喂给 go-test-report？
它不直接运行测试，只解析 go test -json 输出。你得先生成 JSON 流，再管道传给它。
- 正确姿势：
go test -json ./... | go-test-report - 不能漏掉
-json，否则输出是人类可读格式，它解析不了，直接退出且无提示 - 如果测试含并发（比如多个包），建议加
-p=1避免 JSON 行交错，否则报告可能错乱 - 想保存原始 JSON 用于调试？加个
tee report.json：go test -json ./... | tee report.json | go-test-report
导出 HTML 报告但打开是空白页？
常见于本地直接双击打开 index.html，浏览器因安全策略阻止加载内联资源。
- 必须通过 HTTP 服务访问：启动一个静态服务器，例如
python3 -m http.server 8000，然后浏览器打开http://localhost:8000 - 导出时用
--output-dir ./report指定目录，它会生成完整可部署的静态文件（含 JS/CSS） - 别手动修改生成的
index.html—— 所有资源路径是硬编码的，改错一个就白屏 - CI 环境里导出后，记得把整个目录上传，不只是
index.html
和 gotestsum、test2json 比有什么实际区别？
go-test-report 只做一件事：把 go test -json 转成带样式的 HTML 页面。它不替代测试执行器，也不提供失败重试、覆盖率聚合等能力。
立即学习“go语言免费学习笔记（深入）”；
- 如果你只需要一个能发给 PM 看的“好看报告”，它够用；但需要失败用例自动重跑，选
gotestsum - 它的 JSON 解析逻辑较简单，遇到非标准字段（比如自定义 test output 插入的 JSON 片段）可能跳过或崩溃
- 不支持
go test -coverprofile，覆盖率得另用go tool cover处理，再手动合并到报告里 - 移动端适配弱，小屏幕打开表格会横向滚动，别指望它在钉钉里直接预览
真正麻烦的是 JSON 流的稳定性——哪怕一个测试 panic 导致输出不合法 JSON，整个报告就中断。上线前最好加个 jq empty 校验管道是否通畅。
