CMake无法找到CodeCoverage模块问题求助

问题根源 #

CodeCoverage并非gcovr自带的CMake模块，它是独立的CMake配置模块——你的正常WSL机器大概率已手动添加该模块或通过其他途径安装了包含它的包，而故障机器缺少这个文件。

解决步骤 #

1. 获取CodeCoverage.cmake文件 #

有两种可靠方式：

• 从正常的WSL 20.04机器复制：执行find / -name CodeCoverage.cmake找到文件位置，将其复制到故障机器。
• 手动编写基础版：如果仅需append_coverage_compiler_flags命令，可创建CodeCoverage.cmake文件并写入以下内容：

function(append_coverage_compiler_flags)
    if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
        target_compile_options(${PROJECT_NAME} PRIVATE
            -O0
            -g
            --coverage
        )
        target_link_libraries(${PROJECT_NAME} PRIVATE
            --coverage
        )
    endif()
endfunction()

完整模块会包含更多覆盖率报告生成逻辑，若需要可从正常机器复制完整文件。

2. 让CMake定位到模块 #

• 项目内配置（推荐）：将CodeCoverage.cmake放到项目的cmake/Modules目录，在项目根目录的CMakeLists.txt中添加：

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/Modules")

之后即可通过include(CodeCoverage)调用模块功能。

• 全局配置：执行cmake --help-module-path查看CMake全局模块路径，将文件复制到该路径下，所有项目均可直接调用。

3. 验证修复 #

重新运行CMake配置命令（比如cmake -S . -B build -DENABLE_COVERAGE=ON），若原错误消失则修复成功。

注意：gcovr仅用于生成最终覆盖率报告，和CMake的CodeCoverage模块无直接关联，模块的作用是配置编译、链接阶段的覆盖率参数。

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