覆盖率报告生成失败主因是pcov/xdebug未加载或版本不兼容（占90%），其余10%为路径、autoload、参数透传等链路问题；需验证扩展是否生效、配置是否正确、autoload是否注册、命令是否规范。
覆盖率报告生成失败，90% 是因为 pcov 或 xdebug 没真正加载，或加载了但和 PHPUnit 版本/PHP 版本不兼容；剩下 10% 是路径、autoload、参数透传这些“看不见的链路”断了。
确认 pcov/xdebug 是否真生效
CI 或本地跑完 phpunit --coverage-html coverage 却得到空报告，第一件事不是改配置，而是验证扩展是否就位。PHP 8.2+ 必须用 pcov（Xdebug 4 已移除行覆盖率支持），7.4–8.1 推荐 pcov（轻、快、无 Zend 冲突）。
- 执行
php -m | grep -E '^(pcov|xdebug)$'—— 必须有输出，且只出现一个（pcov和xdebug同时启用会静默失效） - 检查
php --ini输出的配置文件路径，确认pcov.ini或xdebug.ini确实被加载；pcov需要显式设置：pcov.enabled=1、pcov.directory="src"（注意不是include路径，是源码根目录） - 运行
php -v和phpunit --version，确保 PHPUnit ≥ 9.5（旧版对pcov支持不完整）
phpunit.xml 中 coverage 配置必须显式 include
phpunit.xml 里只写 <coverage></coverage> 标签没用，php-code-coverage 不会自动扫描 src/；它只覆盖「被加载并执行」的文件，而 autoload 是前提。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在
<coverage></coverage>内补全<include></include>，例如：<directory suffix=".php">src/</directory> - 多模块项目（如
module/foo/src）必须先在composer.json的autoload.psr-4中注册命名空间和路径，再composer dump-autoload，否则即使<include></include>写了也无效 - 避免用
processUncoveredFilesFromWhitelist="true"，它会让未执行的文件也进报告（显示 0%），干扰真实覆盖率判断；真要扫全量，改用<whitelist></whitelist>+processUncoveredFiles="true"
composer exec phpunit -- --coverage-html 容易漏掉关键路径
composer exec 会重设工作目录和环境变量，导致 bootstrap 文件里的相对路径（比如 require __DIR__.'/../vendor/autoload.php'）解析错位，测试全跳过，覆盖率自然为空。
- 直接用
php vendor/bin/phpunit --coverage-html coverage/，绕过composer exec的干扰 -
--coverage-html后必须跟路径（如coverage/），不能只写--coverage-html；目录无需预先创建，但父路径（如./coverage）需有写权限 - CI 中强烈建议把所有覆盖率配置收口到
phpunit.xml的<logging></logging>节点下：<log type="coverage-html" target="coverage/"></log>，命令行只留phpunit，避免参数拼接出错
HTML 报告打不开？不是代码问题，是浏览器策略
本地双击 coverage/index.html 打不开，控制台报 Failed to load resource: net::ERR_FILE_NOT_FOUND，这不是 bug，是 Chrome/Firefox 对 file:// 协议的跨域限制。
- 用 PHP 内置服务器临时起服务：
php -S localhost:8000 -t coverage/，然后访问http://localhost:8000 - CI 场景（如 GitHub Actions）别纠结本地预览，直接用
actions/upload-artifact上传整个coverage/目录，下载解压后用任意 HTTP Server 打开即可 - 若需长期查看趋势，应生成
clover.xml并上传至 Coveralls/Codecov；html报告只是临时调试用，不适合自动化比对
最容易被忽略的是 autoload 和扩展共存问题：模块路径进了 composer.json 却没 dump-autoload，或者 pcov 和 xdebug 在 php.ini 里同时开启——这两处一错，覆盖率就归零，且没有任何错误提示。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
