直接恢复 PHPUnit 配置即可重新运行测试，核心是正确配置 PhpStorm 中的 phpunit 路径、自动加载器及 phpunit.xml 文件，并确保 PHP 解释器版本一致。
直接恢复 PHPUnit 配置即可重新运行测试，不需要重装或改项目结构；核心是让 PhpStorm 正确识别 phpunit 可执行文件，并匹配当前项目的自动加载逻辑。
PHPUnit 路径没配对，测试图标灰掉、右键无 “Run” 选项
这是最常见现象：编辑器里测试类名不标蓝、方法前没有绿色三角图标、右键菜单不出现 Run 项。
- 先确认终端能跑通：
which phpunit（Linux/macOS）或where phpunit（Windows），拿到绝对路径，比如/usr/local/bin/phpunit - 进 Settings → Languages & Frameworks → PHP → PHPUnit，选 “Path to phpunit.phar” 或 “Autoloader path”，**不要选 “PHPUnit library in the project” 后再点 Browse —— 它会误读 vendor/autoload.php 但跳过 bin/phpunit**
- 如果用 Composer 全局安装，填
phpunit命令本身（不是 phar 文件）；如果项目里有vendor/bin/phpunit，就填这个完整路径 - 检查 PHP 解释器是否指向同一环境：Settings → Languages & Frameworks → PHP → CLI Interpreter 必须和
phpunit所依赖的 PHP 版本一致，否则Class not found错误静默出现
测试能启动但报 “Class ‘Tests\TestCase’ not found” 类加载失败
这说明 PHPUnit 找到了，但自动加载没生效，常见于 Laravel、Lumen 或自定义 PSR-4 结构项目。
- Settings → Languages & Frameworks → PHP → PHPUnit → “Test runner” 选 “PHPUnit via composer autoloader”，然后在 “Path to autoloader” 指向项目根目录下的
vendor/autoload.php - 确保
phpunit.xml或phpunit.xml.dist存在于项目根目录，且<testsuites>里包含正确路径，例如：<directory>tests</directory> - 如果用了
--bootstrap参数（如 Laravel 的tests/bootstrap.php），必须在 Settings → PHPUnit → “Custom configuration file” 里显式指定phpunit.xml，不能只靠自动探测 - 重启 PhpStorm 索引：File → Reload project from Disk，否则旧的类映射缓存仍生效
测试通过但覆盖率/断言提示不工作
覆盖率条纹不显示、assertEquals() 无参数提示、$this->mock() 不补全，本质是 PhpStorm 没把测试框架当成“已知上下文”。
立即学习“PHP免费学习笔记（深入）”；
- Settings → Languages & Frameworks → PHP → Test Frameworks → 确保勾选 “Enable testing framework integration” 并选中 PHPUnit
- 若项目含
phpunit.xml，PhpStorm 应自动识别<filter>和<coverage>配置；若没识别，手动点击 “Use custom configuration file” 并重选一次 - 检查 PHP Language Level 是否 ≥ 项目要求（如 Laravel 11 需 PHP 8.2+），Settings → Languages & Frameworks → PHP → Language level，低版本会导致 trait、enum 补全失效
- 插件干扰：禁用非必要插件（尤其 “PHP Annotations”、“Laravel Idea” 旧版），它们有时劫持测试类解析逻辑
恢复关键不在“导出导入设置”，而在确保 phpunit 命令路径、autoload.php 位置、phpunit.xml 存在性三者严丝合缝；任何一环错位，都会导致测试看似启动实则绕过真实框架逻辑。别信“自动检测”，所有路径都得手动验证一遍。
