使用 gotestsum 生成 golang 测试 html 报告的步骤如下：1. 安装 gotestsum，运行 go install gotest.tools/gotestsum@latest；2. 运行测试并生成 junit xml 文件，推荐命令为 gotestsum --format=standard-verbose --junitfile report.xml；3. 转换 xml 为 html，执行 gotestsum --junitfile report.xml --htmlpath report.html；常见问题包括 xml 文件为空、html 样式异常及 ci/cd 中的集成注意事项。
Golang测试生成HTML报告其实并不复杂，结合 gotestsum 工具可以轻松实现。它的核心思路是先运行测试并输出标准的 JUnit XML 格式结果，然后通过 gotestsum 把这些结果转换成 HTML 报告。
安装 gotestsum
在使用之前，需要确保你已经安装了 gotestsum。可以通过下面这个命令安装：
go install gotest.tools/gotestsum@latest
安装完成后，执行 gotestsum --version 确认是否安装成功。
立即学习“go语言免费学习笔记（深入）”；
1. 运行测试并生成JUnit格式文件
Go 自带的测试工具不直接支持 JUnit XML 输出，但你可以借助第三方库（如 go test -v 结合 gotestsum 的 --junitfile 参数）来实现。
运行测试并保存为 JUnit XML 文件的命令如下：
go test -v ./... > report.out
或者更推荐的方式是直接用 gotestsum 来运行测试并输出 XML 文件：
gotestsum --format=standard-verbose --junitfile report.xml
这样会同时在控制台输出详细信息，并将测试结果写入 report.xml 文件中。
2. 使用 gotestsum 转换为 HTML 报告
有了 XML 文件之后，就可以用 gotestsum 把它转成 HTML 格式了。命令如下：
gotestsum --junitfile report.xml --htmlpath report.html
这会在当前目录下生成一个 report.html 文件，用浏览器打开就能看到结构清晰、颜色分明的测试报告了。
如果你希望一次完成测试+生成 HTML 报告的操作，也可以这样写：
gotestsum --junitfile report.xml && gotestsum --junitfile report.xml --htmlpath report.html
3. 常见问题与注意事项
XML 文件内容为空：可能是因为测试没有运行成功，或者没有匹配的测试文件。检查路径是否正确。
HTML 文件样式异常：可能是
gotestsum版本太低，建议更新到最新版。CI/CD 中使用：可以把
report.html作为构建产物上传，方便查看测试情况。-
多个包测试：使用
./...可以递归测试所有子包，例如：gotestsum --junitfile report.xml ./...
基本上就这些步骤了。整个流程虽然看起来有几步，但实际操作起来非常顺畅，尤其适合集成到 CI 流程中做自动化测试报告展示。
