PhpStorm 关联 PHP 测试框架的核心是正确配置 PHPUnit 可执行路径与加载方式：先确保 PHP 解释器有效，再选择“Use composer autoloader”并指向 vendor/autoload.php，同时建议绑定 phpunit.xml 以启用完整功能。
Class 'PHPUnit\Framework\TestCase' not found 或 Cannot find PHPUnit 这类错误。
确认 PHP 解释器已正确配置
这是所有测试运行的前提——没有解释器，PHPUnit 根本无法执行。
- 进
Settings / Preferences → Languages & Frameworks → PHP，检查CLI Interpreter是否指向有效的 PHP 二进制（如/usr/bin/php或 Docker 容器内路径） - 如果用的是远程解释器（如 WSL、Docker），必须确保该环境里已安装
phpunit或vendor/autoload.php可被访问 - 常见坑：
PHP interpreter path指向了系统默认 PHP，但项目实际用 Composer 安装的 PHPUnit 在vendor/bin/phpunit，而 IDE 却没配对——此时即使终端能跑php vendor/bin/phpunit，PhpStorm 也会失败
选择 PHPUnit 安装类型并填对路径
PhpStorm 不关心你“怎么装”的 PHPUnit，只认两种启动方式：通过 autoload.php 加载，或直接调用 phpunit.phar。选错类型，配置再准也白搭。
-
推荐选「Use composer autoloader」：适用于绝大多数 Composer 项目（Laravel、Webman、自建项目）。在
Settings → PHP → Test Frameworks → PHPUnit中勾选此项，然后填：
▸Script path→ 指向vendor/autoload.php（例如$PROJECT_DIR$/vendor/autoload.php） - 若选「phpunit.phar path」：需手动指定
phpunit.phar文件位置；若本地没下载过，点Download phpunit.phar让 PhpStorm 自动拉取（注意：它默认下载最新稳定版，可能不兼容老项目） - 关键细节：
Script path必须是「可被 PHP 解释器直接 require 的路径」。如果用了 Docker 远程解释器，这里填的不是宿主机路径，而是容器内路径（如/var/www/vendor/autoload.php）
绑定 phpunit.xml 配置文件（非必需但强烈建议）
没配 phpunit.xml，PhpStorm 也能跑测试，但会忽略白名单、bootstrap、测试目录等关键逻辑，覆盖率分析、自动发现测试类都可能失效。
- 在
Test Frameworks页面底部，填入Default configuration file路径，比如$PROJECT_DIR$/phpunit.xml - 一个最小可用的
phpunit.xml示例：
<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php" colors="true">
<testsuites>
<testsuite name="Tests">
<directory suffix="Test.php">./tests</directory>
</testsuite>
</testsuites>
<filter>
<whitelist processUncoveredFilesFromWhitelist="true">
<directory suffix=".php">./app</directory>
</whitelist>
</filter>
</phpunit>
- 注意：
bootstrap值必须与你上面填的Script path逻辑一致；如果Script path是vendor/autoload.php，这里就不能写成tests/bootstrap.php，否则启动时找不到类
验证是否生效：三秒快速测试法
别急着写完整测试类，先用最简方式验证关联成功。
立即学习“PHP免费学习笔记（深入）”；
- 在
tests/目录下新建DemoTest.php：
<?php
use PHPUnit\Framework\TestCase;
class DemoTest extends TestCase
{
public function testTrueIsTrue(): void
{
$this->assertTrue(true);
}
}
- 把光标放在
testTrueIsTrue方法内，按Ctrl+Shift+F10（macOS 是Cmd+4） - 看下方
Run窗口是否输出绿色OK (1 test)；如果报错，重点查Script path和phpunit.xml中的bootstrap是否指向同一份 autoload - 如果项目用了 Laravel 或 Webman，且
tests/bootstrap.php里有额外初始化逻辑（如加载配置），那就不能只依赖vendor/autoload.php，必须把bootstrap改成tests/bootstrap.php，并在该文件中显式require vendor/autoload.php
