Composer本身不支持更新后自动检查覆盖率，必须依赖外部机制；其post-update-cmd钩子无法保证测试环境就绪，易导致Class not found或静默失败，应改用composer run coverage等显式、可调试命令。
Composer 本身不支持“更新后自动检查覆盖率”——它没有钩子能监听 composer update 完成并触发 PHPUnit 或覆盖率工具。所谓“自动”，必须靠外部机制补足，否则只会卡在“想但做不到”。
为什么 composer update 不能直接触发覆盖率检查
Composer 的 scripts 钩子（如 post-update-cmd）只运行命令，不区分“更新了什么”。哪怕你只改了一个 dev 依赖，它也会无差别执行；而覆盖率检查需要：源码存在、测试可运行、覆盖率扩展（如 pcov 或 xdebug）已加载——这些条件 post-update-cmd 根本不保证。
-
post-update-cmd在composer install时也触发，容易误判场景 - 它默认不加载
autoload-dev，tests/下的类大概率报Class not found - 没 PHP 扩展可用时硬跑
phpunit --coverage-html会静默失败或报错PHP Warning: Xdebug: Failed to open code coverage file
真正可行的替代方案：用 composer run 组合 + 显式触发
把覆盖率检查变成一个**可复现、可调试、可 CI 复用**的命令，而不是绑死在 update 上：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的scripts里定义："coverage": "vendor/bin/phpunit --coverage-html=build/coverage --colors=always" - 确保
phpunit.xml.dist中<coverage>段已启用，且<directory>src/</directory>路径正确 - 运行前手动确认环境：
php -m | grep pcov（PHP ≥ 8.0 推荐）或php -v | grep xdebug（PHP ≤ 8.1） - CI 中用
composer run coverage替代composer update && composer coverage，避免中间状态污染
如果真要“更新后顺手测”，得加一层守卫逻辑
写个轻量脚本（如 bin/coverage-if-safe），在 post-update-cmd 里调用它，而非直接跑 phpunit：
#!/usr/bin/env php
<?php
if (!extension_loaded('pcov') && !extension_loaded('xdebug')) {
echo "⚠️ 覆盖率扩展未加载，跳过 coverage 检查\n";
exit(0);
}
if (!file_exists('vendor/autoload.php')) {
echo "⚠️ autoload 未生成，跳过\n";
exit(0);
}
passthru('vendor/bin/phpunit --coverage-html=build/coverage --colors=always');
然后在 composer.json 中写："post-update-cmd": ["@php bin/coverage-if-safe"]。这样既不破坏流程，又避开多数静默失败。
最常被忽略的一点：覆盖率不是越全越好，而是得和 git diff 结合看——新代码有没有被测到，比整体 92% 还是 95% 重要得多。工具链可以自动化，判断力还得人来把关。
