根本原因是VSCode不生成测试数据，只读取展示；需PHPUnit自动生成报告（如lcov.info）并确保路径、Xdebug、autoload等配置全对齐。
VSCode 跑不了 PHPUnit 测试或看不到覆盖率，根本原因只有一个：它不生成数据，只读取和展示。你得让 phpunit 自己输出报告，再让插件找到那个文件。
PHPUnit 测试在 VSCode 里点不动？先确认 CLI 环境能跑通
VSCode 的“运行测试”按钮背后调的是命令行，不是 GUI。如果终端里都跑不起来 ./vendor/bin/phpunit，VSCode 必然失败。
- 打开集成终端，执行
./vendor/bin/phpunit --version—— 必须有输出；若报错command not found，说明 Composer 没装好或没生成 bin 文件 - 检查
composer.json是否声明了"phpunit/phpunit": "^9"（或对应版本），然后运行composer install - 确保项目根目录下存在
phpunit.xml或phpunit.xml.dist，且配置了bootstrap和testsuite，否则自动发现测试类会失败 - 别依赖全局安装的 phpunit —— VSCode 插件默认走
./vendor/bin/phpunit，路径硬编码，改不了
断点灰色、调试无响应？Xdebug 配置必须分三层对齐
PHP CLI 有 Xdebug ≠ VSCode 调试器能用它。三处配置必须同时生效，缺一不可：
-
php --ini查看 Loaded Configuration File，打开那个php.ini，确认含zend_extension=xdebug.so和xdebug.mode=debug（Xdebug 3.x 不认remote_enable） - VSCode 的
.vscode/launch.json中必须带"env": { "XDEBUG_MODE": "debug" }，否则 PHP Debug 扩展收不到信号 -
launch.json还要显式指定"port": 9003（Xdebug 3 默认端口），且与xdebug.client_port=9003一致；改过端口就全得同步 - 如果用了 Docker/WSL，注意
xdebug.client_host应设为宿主机 IP（如10.0.2.2），而非localhost
覆盖率数字为空、Coverage Gutters 显示 “no coverage data”？PHPUnit 没输出 lcov.info
Coverage Gutters 插件只读文件，不干活。它默认找 coverage/lcov.info，但 PHPUnit 默认根本不生成这个文件。
立即学习“PHP免费学习笔记（深入）”；
- 在
phpunit.xml里加<logging><log type="coverage-clover" target="coverage/clover.xml"/><log type="coverage-text" target="php://stdout"/><log type="coverage-html" target="coverage/html"/><log type="coverage-crap4j" target="coverage/crap4j.xml"/></logging>—— 这些都不够，lcov 格式必须手动启用 - 运行命令要带
--coverage-cobertura或--coverage-text，但 Coverage Gutters 只认lcov；所以得用phpunit --coverage-xml=coverage/coverage-xml.xml+phpcov merge --format=lcov coverage/ > coverage/lcov.info（需额外装phpunit/phpcov） - 更简单的方式：改用
phpdbg（PHP 内置）+--coverage参数，它原生支持lcov输出，无需转换 - 确认
coverage/lcov.info真的存在，且第一行是TN:开头；若内容为空或格式错误，Coverage Gutters 会静默失败
覆盖率染色错位、某行标红又变绿？lcov.info 里的路径和 VSCode 打开的文件对不上
lcov.info 每个 SF: 行记录源码绝对路径，VSCode 必须打开完全相同的路径才能匹配染色。
- 常见错位：你在
/home/user/project/src/Calculator.php编辑，但lcov.info里写的是SF:/var/www/project/src/Calculator.php（Docker 构建残留） - 临时修复：用
sed -i 's|/var/www/project|/home/user/project|g' coverage/lcov.info替换路径前缀 - 长期方案：在
phpunit.xml的<filter>下加<path>显式指定源码根目录，或用phpcov的--prefix参数标准化路径 - 别用相对路径生成报告 ——
phpunit --coverage-lcov coverage/lcov.info在非项目根目录执行会导致SF:路径混乱
最易被忽略的一点：PHPUnit 的覆盖率统计依赖 autoload 正确加载被测类。如果 phpunit.xml 里 bootstrap 指向的文件没触发 Composer 自动加载，或 src/ 目录没在 composer.json 的 "autoload" 里声明，那所有被测代码都会显示为“未覆盖”，哪怕测试本身通过了。
