如何让Go测试覆盖率报告包含跨模块测试文件的覆盖情况

问题背景 #

当前执行的测试命令：

gotestsum --junitfile-testcase-classname=short --junitfile-testsuite-name=relative \
 -- -coverprofile=coverage.out ./serviceName/...

目录结构：

serviceName
  normalModule
     - file.go
     - file_test.go
  testModule
     - file2_test.go
     - file3_test.go
  otherModule 
     - file3.go
  - file2.go

需求是让覆盖率报告统计normalModule、otherModule和serviceName根模块的覆盖率（即使测试文件不在对应模块内），但当前报告仅统计了normalModule，其余模块均被跳过：

• serviceName/normalModule (5ms) (coverage: 100.0% of statements)
• ∅ serviceName
• ∅ serviceName/testModule
• ∅ serviceName/testModule

原因 #

Go默认仅统计测试文件所在模块的代码覆盖率，testModule中的测试文件如果针对serviceName根目录或otherModule的代码，这些目标模块不会被自动纳入统计范围。

解决方案 #

方法1：显式指定需要统计的模块 #

直接通过-coverpkg参数列出所有要覆盖的模块，确保跨模块测试的代码被统计：

gotestsum --junitfile-testcase-classname=short --junitfile-testsuite-name=relative \
 -- -coverprofile=coverage.out -coverpkg=./serviceName,./serviceName/normalModule,./serviceName/otherModule ./serviceName/...

• -coverpkg用于指定覆盖率统计的目标包列表，逗号分隔，不受测试文件所在位置限制。

方法2：通配符批量指定模块 #

如果模块数量较多，用通配符简化配置，覆盖serviceName下所有子模块及根模块：

gotestsum --junitfile-testcase-classname=short --junitfile-testsuite-name=relative \
 -- -coverprofile=coverage.out -coverpkg=./serviceName/... ./serviceName/...

• ./serviceName/...会匹配serviceName根目录及所有子目录的模块，一次性纳入所有相关代码的覆盖率统计。

效果验证 #

执行修改后的命令后，生成的coverage.out会包含指定模块的覆盖率数据，gotestsum报告将显示serviceName、otherModule的覆盖率（前提是测试代码覆盖了这些模块的语句）。

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