PhpStorm 运行 PHPUnit 失败主因是路径或自动加载问题，phpunit.xml 必须严格位于项目根目录且大小写准确，需右键标记为 PHPUnit 配置文件，否则需检查 PHP 插件是否启用或升级 PhpStorm。
PhpStorm 跑不起来 PHPUnit，90% 是路径或自动加载没对齐，不是“配置没点对”这种玄学问题。
phpunit.xml 文件必须在项目根目录且被正确识别
PhpStorm 不会自动扫描子目录找 phpunit.xml 或 phpunit.xml.dist。它只认项目最顶层（即你用 PhpStorm 打开的那个文件夹）下的这两个文件名，大小写一个字母都不能错。
- 检查文件是否真实存在于项目根目录：
ls -la phpunit.xml*（Linux/macOS）或dir phpunit.*（Windows） - 右键点击该文件 → 选 Mark as PHPUnit Configuration File；如果菜单里没有这项，说明 PHP 插件未启用，或 PhpStorm 版本太旧（
- 打开
phpunit.xml，确认顶层标签是<phpunit>，不是<?xml>开头就报错——那是 XML 声明，不是 PHPUnit 配置根节点
vendor/bin/phpunit 必须可执行，且 PhpStorm 知道它在哪
PhpStorm 不关心你是不是全局装了 phpunit，它只认你项目里 vendor/bin/phpunit（Linux/macOS）或 vendorinphpunit.bat（Windows）这个路径。用 composer 安装是唯一推荐方式。
- 运行
composer require --dev phpunit/phpunit:^10（PHP 8.1+ 推荐 v10） - 在 Settings → PHP → Test Frameworks → PHPUnit 中，选择 PHPUnit library path → 点右侧
...→ 导航到vendor/autoload.php（不是phpunit.phar） - 不要手动填
vendor/bin/phpunit到 “Path to phpunit.phar” 栏——那栏只接受 .phar 文件，填了反而报错
测试类找不到？先看 autoload-dev 和命名空间
报错 Class "TestsUnitExampleTest" could not be found，不是 PhpStorm 设置问题，是 Composer 自动加载根本没注册这个类。
立即学习“PHP免费学习笔记（深入）”；
- 检查
composer.json的autoload-dev是否把Tests映射到了tests/目录，例如："Tests\": "tests/" - 测试类文件路径要和命名空间严格对应：比如类声明
namespace TestsUnit;，那文件就得在tests/Unit/ExampleTest.php - 改完
composer.json后必须运行composer dump-autoload -o，否则 PhpStorm 和 CLI 都不会重新识别新类 - 在 PhpStorm 中右键
tests目录 → Mark Directory as → Test Sources Root（显示为绿色图标），否则 IDE 不会把它当测试入口
Xdebug 调试失败？重点查路径映射和启动模式
断点进不去、提示 “No executable code found” —— 八成是 Xdebug 把远程路径（如 /var/www/html）映射错了，或者 PHP 启动时根本没加载 Xdebug。
- CLI 运行测试时，确保 PHP 解释器启用了 Xdebug：在 Run → Edit Configurations → Templates → PHPUnit 的 Interpreter options 里加
-d xdebug.mode=debug -d xdebug.start_with_request=yes（PHP 8.1+） - 在 Settings → PHP → Servers 中添加 localhost 服务器，Host 填
localhost，Port 填你 Web 服务端口（如 8080），并勾选 Use path mappings，把远程路径（如/var/www/html）映射到你的本地项目根目录 - 不要开启 Filter debug connection by IDE key（Settings → PHP → Debug → Xdebug），除非你真在一台机器上同时跑多个 PhpStorm 实例
最容易被忽略的其实是 composer dump-autoload -o 这一步——改了命名空间、挪了测试文件、新增了 autoload-dev 规则，不执行它，PhpStorm 就永远找不到你的测试类，无论配置点得多漂亮。
