必须配置Composer自动加载器：进入Settings → Tools → PHP → Test Frameworks，点击+选择“PHPUnit by Composer autoloader”，在Path to autoloader中填写项目根目录下的vendor/autoload.php绝对路径，不可填phpunit.phar或vendor/bin/phpunit。
PhpStorm 找不到 PHPUnitFrameworkTestCase 怎么办
不是 PHPUnit 没装，是 PhpStorm 没连上自动加载器。它根本没机会去加载那个类。
必须进 Settings → Tools → PHP → Test Frameworks，点 + → 选 PHPUnit by Composer autoloader，然后在 Path to autoloader 栏填 vendor/autoload.php（绝对路径，不能是 phpunit.phar 或 vendor/bin/phpunit）。
- 填错成
vendor/bin/phpunit或phpunit.phar：会报Class 'PHPUnitFrameworkTestCase' not found，因为那俩是执行入口，不是加载器 - 项目用的是 Composer 全局安装（
composer global require phpunit/phpunit）：别选Global installation，它大概率找不到 autoload.php；坚持用项目级vendor/autoload.php - 刚
composer require --dev phpunit/phpunit完但还没生成vendor/autoload.php：先跑一次composer install或composer dump-autoload -o
右键 Run ‘Tests in xxx’ 没反应或报 Class "TestsUnitExampleTest" could not be found
这是 PSR-4 自动加载断了，和 PhpStorm 配置关系不大，得查你自己的 composer.json 和文件路径。
假设测试类声明 namespace TestsUnit;，那它必须放在 tests/Unit/ExampleTest.php，且 composer.json 的 autoload-dev 要映射对：
立即学习“PHP免费学习笔记（深入）”；
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
- 改完
composer.json后不运行composer dump-autoload -o：PhpStorm 和 CLI 都不会识别新类 -
tests/目录没被标记为测试根：右键该目录 →Mark Directory as → Test Sources Root（图标变绿才算生效） - 文件名大小写不一致（比如类叫
ExampleTest，文件存成exampletest.php）：Linux/macOS 下直接加载失败，Windows 可能侥幸通过但不可靠
为什么 phpunit.xml 写好了却不起作用
PhpStorm 不扫描子目录，只认项目最顶层（你打开的那个文件夹）下的 phpunit.xml 或 phpunit.xml.dist，一个字母都不能错。
- 文件不在根目录：比如放在
config/phpunit.xml，PhpStorm 就当它不存在 - 没右键标记：即使文件存在，也得右键它 →
Mark as PHPUnit Configuration File；没这选项？检查 PHP 插件是否启用（Settings → Plugins里搜PHP） - 文件内容无效：开头必须是
<phpunit></phpunit>根节点，不能只有<?xml version="1.0"?>；至少要有<testsuites></testsuites>或<bootstrap></bootstrap> - 用了自定义配置但没勾选
Use custom configuration file：在Test Frameworks设置里要手动指定路径
覆盖率显示 0%，Xdebug 明明开着也没用
两个硬性条件缺一不可：一是 CLI PHP 真启用了 Xdebug（php -m | grep xdebug 有输出），二是 PhpStorm 必须用 Run with Coverage 启动，且设置里选对驱动。
- 普通右键
Run不会收集覆盖率数据，必须选Run with Coverage（右键菜单或快捷键Ctrl+Shift+F9） -
Settings → Tools → Coverage中的Coverage runner必须设为Xdebug—— 即使你实际用的是 PCOV，PhpStorm 当前版本（2026 年）仍只认 Xdebug 作为覆盖率后端 - Xdebug 3 需确认
xdebug.mode=coverage（不是debug或develop），且xdebug.start_with_request=trigger或yes
最常被忽略的一点：所有路径都依赖真实文件系统结构，而不是“看起来像”。比如 vendor/autoload.php 路径写错一位、tests/ 没标为测试根、phpunit.xml 放错目录层级——这些都不会报明确错误，只会静默失效。验证时优先用终端命令 ./vendor/bin/phpunit tests/ExampleTest.php 看是否能跑通，再回头调 IDE。
