必须配置项目级vendor/autoload.php绝对路径：进入settings→tools→php→test frameworks，点击+选phpunit by composer autoloader，path to autoloader填项目根目录下vendor/autoload.php（不可填vendor/bin/phpunit或phpunit.phar），否则跳过自动加载导致testcase类找不到。
PhpStorm 运行测试提示 Class 'PHPUnitFrameworkTestCase' not found，根本不是 PHPUnit 没装，而是它压根没走 Composer 自动加载链路——必须用 vendor/autoload.php，不能填 vendor/bin/phpunit 或 phpunit.phar。
为什么填 vendor/bin/phpunit 会报错
因为 vendor/bin/phpunit 是一个封装脚本（shebang + require），它本身不提供类加载能力；PhpStorm 在“Test Frameworks”里填这个路径时，会尝试直接执行它，但跳过了 Composer 的 autoloader 初始化流程，导致 PHPUnitFrameworkTestCase 等核心类完全不可见。
- 填
phpunit.phar同理：.phar 文件是自包含包，但 PhpStorm 若未正确识别其内部 autoloader，或版本与项目不兼容，也会失败 - 选 “Global installation” 更危险：全局安装的
autoload.php路径不稳定（比如~/.composer/vendor/autoload.php），且 PhpStorm 的 Terminal 和 Test Runner 环境变量常不一致，极易断链 - 正确路径只能是项目级的
vendor/autoload.php，且必须是绝对路径（如/home/user/myapp/vendor/autoload.php）
怎么配对 vendor/autoload.php
进 Settings → Tools → PHP → Test Frameworks，点击 + → 选 PHPUnit by Composer autoloader，在 Path to autoloader 栏粘贴完整绝对路径。
- 路径不对？先终端执行
ls -l vendor/autoload.php确认文件存在且可读 - 刚跑完
composer require --dev phpunit/phpunit？立刻补一句composer dump-autoload -o，否则 autoload.php 里还没注册 PHPUnit 类 - 用 Docker/WSL 远程解释器？这里填的必须是容器内或 WSL 内的路径（如
/var/www/vendor/autoload.php），不是宿主机路径
右键 Run ‘Tests in xxx’ 没反应 or 报 Class "TestsUnitExampleTest" could not be found
这不是 PhpStorm 配置问题，是 Composer 自动加载没生效——IDE 只是把类名扔给 PHP 执行，PHP 找不到类，就挂了。
- 检查
composer.json的autoload-dev是否映射了测试命名空间，例如："Tests\": "tests/" - 测试类声明
namespace TestsUnit;？那文件必须放在tests/Unit/ExampleTest.php，大小写、目录层级、文件名（ExampleTest.php）全要严格匹配 PSR-4 - 改过
composer.json或移动过测试文件？必须运行composer dump-autoload -o，否则 PhpStorm 和 CLI 都不会更新类索引 - 确认
tests/目录已右键 →Mark Directory as → Test Sources Root（图标变绿），否则 IDE 不主动扫描该目录下的测试类
phpunit.xml 没被识别，覆盖率显示 0%
没绑定配置文件，PhpStorm 就不知道该跑哪些测试、从哪 bootstrap、是否启用 Xdebug——结果就是“能跑但没覆盖”，或干脆跳过某些测试套件。
- 把
phpunit.xml放项目根目录，内容至少含<phpunit bootstrap="vendor/autoload.php"></phpunit> - 在
Settings → Tools → PHP → Test Frameworks → PHPUnit勾选Use custom configuration file，指定该文件路径 - 改完
phpunit.xml后，右键该文件 →Reload configuration，避免缓存残留 - 覆盖率分析依赖 Xdebug，确保 PHP 解释器已启用 Xdebug（
php -m | grep xdebug），且 PhpStorm 的Run with Coverage模式已开启
真正卡住的点从来不是“会不会写测试”，而是 autoload.php 路径对不对、PSR-4 映射严不严格、dump-autoload 执行没执行——这三件事没做实，再好的测试代码也跑不起来。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
