macOS 下常用代码测试覆盖率工具的安装及配置

macOS 下配置代码测试覆盖率工具需按语言栈选择：Clang+llvm-cov适用于C/C++/Objective-C；Xcode内置方案适用于Swift/Objective-C；pytest-cov用于Python；Slather增强Xcode报告。

macos 下配置代码测试覆盖率工具，关键在于匹配项目语言栈和构建系统。不需要堆砌所有工具，选对一两个、配稳就能有效监控质量。

Clang + llvm-cov（C/C++/Objective-C 项目首选）

这是 macOS 原生最顺滑的组合，无需额外安装编译器，只要 LLVM 工具链完整即可：

• 用 Homebrew 安装最新版：brew install llvm，然后把 /opt/homebrew/opt/llvm/bin（Apple Silicon）或 /usr/local/opt/llvm/bin（Intel）加进 PATH
• 编译时启用覆盖率：在 CMake 中添加 -fprofile-instr-generate -fcoverage-mapping；Xcode 项目则在 Build Settings 中打开 Generate Test Coverage Files 和 Instrument Program Flow
• 运行测试后生成 .profraw 文件，用 llvm-profdata merge -sparse *.profraw -o coverage.profdata 合并，再用 llvm-cov show ./exe -instr-profile=coverage.profdata 查看行级覆盖，或 llvm-cov report 输出汇总

Xcode 自带覆盖率（Swift / Objective-C UI/单元测试）

对原生 iOS/macOS 开发者来说，这是开箱即用的方案，无需第三方工具：

• 确保测试 Target 的 Test Plan 已启用，并在 Scheme 的 Test 设置页勾选 Gather coverage for all targets
• 运行测试（Cmd+U 或 xcodebuild test 命令），Xcode 会自动生成覆盖率数据
• 测试完成后，在 Report Navigator（Cmd+9）中点开最近一次测试报告，切换到 Coverage 标签页，可查看函数、行、分支覆盖详情，支持按文件筛选

pytest-cov（Python 项目标准方案）

适合脚本工具、CLI 工具或 Python 后端服务类项目：

• 安装：pip install pytest pytest-cov
• 在项目根目录运行：pytest --cov=src --cov-report=html --cov-fail-under=80（假设源码在 src/ 目录，低于 80% 覆盖率则失败）
• 报告生成在 htmlcov/index.html，直接用浏览器打开，点击文件可定位未覆盖行
• 如需与 VSCode 深度集成，安装 Python Test Explorer 扩展，并在 .vscode/settings.json 中设置 "python.testing.pytestArgs": ["--cov=src", "--cov-report=html"]

Slather（Xcode 项目的增强报告生成器）

当 Xcode 内置界面不够用，需要导出 HTML 报告或对接 CI 时，Slather 是成熟选择：

• 安装：gem install slather（确保已装 Ruby 环境）
• 配置 .slather.yml 指定 xcworkspace、scheme 和 output_directory
• 执行：slather coverage --build-directory DerivedData/ --output-directory coverage-report，生成带样式的 HTML 报告
• 支持输出 Cobertura XML，方便上传到 SonarQube 或 Codecov