phpstorm仅识别项目根目录下的phpunit.xml或phpunit.xml.dist，需确保文件存在、命名准确、根节点为、tests目录标记为test sources root，并配置composer autoloader路径为vendor/autoload.php。
phpunit.xml 文件不在项目根目录
PhpStorm 只认你用它打开的那个文件夹（即项目根目录）下的 phpunit.xml 或 phpunit.xml.dist，不会递归扫描子目录，也不会自动 fallback 到上级目录。常见错误是把配置文件放在 tests/ 或 config/ 里，结果 PhpStorm 完全无视。
实操建议：
- 终端执行
ls -la phpunit.*（macOS/Linux）或dir phpunit.*（Windows），确认文件真实存在于项目最顶层目录 - 文件名必须完全匹配——
PHPUNIT.XML、phpunit.xml.bak、phpunit.yml都无效 - 右键点击该文件 → 选 Mark as PHPUnit Configuration File；如果菜单里没有这项，说明 PHP 插件未启用或 PhpStorm 版本太旧（低于 2021.3）
phpunit.xml 根节点格式错误
PhpStorm 解析配置时会校验 XML 结构，如果顶层不是 <phpunit></phpunit>，而是以 <?xml 开头，或者内容为空、嵌套错乱，就会静默忽略整个文件，不报错也不提示。
实操建议：
- 打开
phpunit.xml，确保第一行是<phpunit>（不是 <code><?xml），且至少包含<testsuites></testsuites>或<bootstrap></bootstrap>子节点 - 一个最小可用配置示例：
<phpunit bootstrap="vendor/autoload.php"><testsuites><testsuite name="Unit"><directory>tests/Unit</directory></testsuite></testsuites></phpunit>
- 改完立即保存，再右键重新 Mark 一次，避免缓存残留
tests 目录没被标记为 Test Sources Root
即使 phpunit.xml 正确，PhpStorm 仍可能找不到测试类，因为 IDE 默认不把任意目录当测试入口。它只在标记为 Test Sources Root 的目录下主动索引测试类、支持右键运行、识别 #[Test] 属性等。
实操建议：
- 在项目视图中右键
tests/目录 → Mark Directory as → Test Sources Root（图标会变成绿色） - 若项目结构是
tests/Unit/ExampleTest.php，但命名空间是TestsUnit，需确保composer.json中"autoload-dev": { "psr-4": { "Tests\": "tests/" } }已配置 - 改完
composer.json后必须运行composer dump-autoload -o，否则 PhpStorm 和 CLI 都无法加载新类
PHPUnit autoloader 路径配错
很多人在 Settings → PHP → Test Frameworks → PHPUnit 里填了 vendor/bin/phpunit 或 phpunit.phar，结果报 Class 'PHPUnitFrameworkTestCase' not found——这是因为 PhpStorm 用错了加载路径，绕过了 Composer 的自动加载机制。
实操建议：
- 务必选择 PHPUnit by Composer autoloader（不是 “PHPUnit library” 或 “Path to phpunit.phar”）
-
Path to autoloader栏只填vendor/autoload.php，绝对不要填vendor/bin/phpunit - 如果用了自定义 bootstrap 文件（如
tests/bootstrap.php），要在phpunit.xml的bootstrap属性里声明，并确保该文件能正常 requirevendor/autoload.php
dump-autoload，都会导致 PhpStorm 表现为“找不到测试”。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
