覆盖率报告为空的首要原因是pcov或xdebug未真正加载，需执行php -m验证扩展存在且唯一，并确认php --ini指向的配置文件中pcov.enabled=1或xdebug.mode=coverage已正确设置。
覆盖率报告为空？先确认 pcov 或 xdebug 是否真加载
CI 里跑 phpunit --coverage-html coverage 却生成空目录，90% 的原因是扩展没生效，不是配置写错了。PHP 8.2+ 必须用 pcov（Xdebug 4 已移除行覆盖率支持），7.4–8.1 推荐 pcov（轻、快、无 Zend 冲突）。
必须执行两步验证：
-
php -m | grep -E '^(pcov|xdebug)$'—— 输出里只能有一个，同时启用会静默失效 -
php --ini看加载的配置路径，确认pcov.ini或xdebug.ini确实被读取；pcov还需显式设pcov.enabled=1和pcov.directory="src"（注意是源码根目录，不是vendor/）
autoload 没注册？覆盖率扫描直接跳过文件
覆盖率只统计「被 autoloader 加载并实际执行」的类。如果 composer.json 里没在 autoload.psr-4 中注册命名空间和路径，或没运行 composer dump-autoload，即使 phpunit.xml 的 <include> 写了 src/，也不会扫描任何文件。
常见漏点：
- 多模块项目（如
modules/foo/src）必须先注册"Foo\": "modules/foo/src/"，再dump-autoload -
phpunit.xml里只写<coverage>标签不够，必须补全<include>块：<directory suffix=".php">src/</directory> - 避免
processUncoveredFilesFromWhitelist="true"—— 它会让未执行文件也进报告（显示 0%），干扰真实覆盖率判断
CI 中 composer exec 导致 bootstrap 失效？路径解析错位
composer exec 会重设工作目录和环境变量，导致 bootstrap.php 里类似 require __DIR__.'/../vendor/autoload.php' 的相对路径解析失败——autoload 没注册，测试全跳过，覆盖率自然为空。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法：
- 不要用
composer exec phpunit，直接用phpunit命令 - 确保
phpunit是全局可执行（CI 镜像已装）或通过vendor/bin/phpunit调用 - 若必须用
composer exec，改用绝对路径加载 autoload，或在 CI 脚本中显式cd到项目根目录
HTML 报告打不开？不是代码问题，是浏览器策略
本地双击 coverage/index.html 打不开，控制台报 net::ERR_FILE_NOT_FOUND，这不是 bug，是 Chrome/Firefox 对 file:// 协议的跨域限制。
CI 场景下无需处理，但本地验证时要：
- 用
php -S localhost:8000 -t coverage启一个临时服务器访问 - 或把
coverage/目录拖进 VS Code，用 Live Server 插件打开
真正容易被忽略的是：CI 流水线里生成的覆盖率报告，必须由后续步骤（比如上传到 codecov.io 或 sonarqube）消费，而不是靠人工点击查看——一旦漏掉上传逻辑，整个覆盖率链路就断在最后一步。
