如何在自定义目录下用go test生成多包代码覆盖率报告？

先确认你的项目结构（方便后续方案对应）：

├── Makefile
├── ...
├── src
│   ├── app
│   │   ├── main.go
│   │   ├── models
│   │   ├── ...
│   │   ├── dao.go
│   │   ├── ...
│   │   └── controllers
│   │       ├── ...
│   │       └── pingController.go
│   └── test
│       ├── all_test.go
│       ├── ...
│       └── controllers_test.go
└── vendor
    └── src
        ├── github.com
        ├── golang.org
        └── gopkg.in

针对你现在用自定义脚本逐个包生成覆盖率的痛点，推荐以下几种更高效的实现方式：

1. 用go test批量生成单包覆盖率报告 #

Go原生的go test支持通配符批量处理包，不用手动逐个指定。你可以直接在项目根目录执行以下命令：

如果需要为每个包单独生成覆盖率文件，用这个简短的shell命令替代自定义脚本：

for pkg in $(go list ./src/app/...); do
  pkg_name=$(basename $pkg)
  go test $pkg -coverprofile=coverage-$pkg_name.out
done

它会自动遍历src/app下的所有子包，为每个包生成以包名命名的覆盖率文件。

要是只想生成整体的覆盖率数据，直接执行：

go test ./src/app/... -coverprofile=coverage-all.out -coverpkg=./src/app/...

2. 合并多包覆盖率为可视化报告 #

如果需要查看所有包的整体覆盖情况，或者生成直观的HTML报告，可以按以下步骤操作：

步骤1：生成合并的覆盖率文件 #

# 初始化合并后的覆盖率文件，声明覆盖模式
echo "mode: atomic" > coverage-all.out

# 遍历所有业务包，执行测试并追加覆盖率数据
for pkg in $(go list ./src/app/...); do
  go test $pkg -coverprofile=coverage-tmp.out -covermode=atomic
  # 跳过每个临时文件的第一行模式声明，追加到总文件
  tail -n +2 coverage-tmp.out >> coverage-all.out
  rm coverage-tmp.out
done

步骤2：生成HTML可视化报告 #

用Go官方的cover工具生成直观的网页报告：

go tool cover -html=coverage-all.out -o coverage-all.html

打开这个HTML文件，就能看到src/app下所有包的覆盖率详情，包括每个文件、每一行的覆盖状态。

3. 集成到Makefile实现一键执行 #

把上面的逻辑集成到项目根目录的Makefile里，以后只需要一条命令就能完成所有操作：

.PHONY: coverage coverage-html

# 生成合并的覆盖率数据文件
coverage:
	@echo "Generating coverage reports..."
	@echo "mode: atomic" > coverage-all.out
	@for pkg in $$(go list ./src/app/...); do \
		go test $$pkg -coverprofile=coverage-tmp.out -covermode=atomic; \
		tail -n +2 coverage-tmp.out >> coverage-all.out; \
		rm coverage-tmp.out; \
	done

# 一键生成可视化HTML报告
coverage-html: coverage
	@go tool cover -html=coverage-all.out -o coverage-all.html
	@echo "Coverage report generated at coverage-all.html"

现在只需要在项目根目录执行：

make coverage-html

就能自动完成所有包的测试、覆盖率统计，并生成可视化报告，完全替代自定义脚本，维护成本更低。

注意事项 #

• 因为你的测试文件在src/test目录（而非业务代码同目录），如果需要用这些测试覆盖业务代码，执行测试时要指定测试包路径并关联业务包：go test ./src/test/... -coverpkg=./src/app/...
• go test默认会忽略vendor目录下的包，刚好符合你只统计自有业务代码覆盖率的需求
• -covermode=atomic适合有并发逻辑的项目，如果没有并发场景，用-covermode=count或-covermode=set也可以

内容的提问来源于stack exchange，提问作者Bunyk