PhpStorm集成PHPUnit单元测试_编写与运行测试用例教程-phpstorm-PHP中文网

根本原因是composer自动加载器未正确接入，需检查autoload-dev映射、文件路径与命名空间一致性、运行composer dump-autoload -o刷新、标记tests为test sources root，并确保phpunit.xml位于项目根目录且被正确识别。

phpstorm集成phpunit单元测试_编写与运行测试用例教程

PhpStorm 里点绿色箭头却报 Class 'PHPUnitFrameworkTestCase' not found，基本不是代码问题，而是自动加载或配置路径没对上。

根本原因不是“没装 PHPUnit”，而是 Composer 自动加载器没被正确接入。PhpStorm 不会自己猜命名空间和文件路径，它只认 vendor/autoload.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 不会扫描这个目录

PhpStorm 只在项目根目录（即你打开项目的那个文件夹）下认 phpunit.xml 或 phpunit.xml.dist，大小写一个字母都不能错，且必须被标记为配置文件。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

用终端确认文件真实存在：ls -la phpunit.*（macOS/Linux）或 dir phpunit.*（Windows）
右键点击该文件 → 必须能看到 Mark as PHPUnit Configuration File；没有这个菜单，说明 PHP 插件未启用或 PhpStorm 版本太旧（
phpunit.xml 的根节点必须是 <phpunit></phpunit>，不能只有 XML 声明（<?xml version="1.0"?>）；至少要包含 <testsuites></testsuites> 或 bootstrap 子节点

Settings → Tools → PHP → Test Frameworks → 点 + → 选 PHPUnit by Composer autoloader，这是唯一推荐方式。

Path to autoloader 填项目根目录下的 vendor/autoload.php（不是 vendor/bin/phpunit，也不是 phpunit.phar）
勾选 Use custom configuration file 并指定 phpunit.xml 路径（通常就是项目根目录下那个）
绝对不要选 PHPUnit library（旧版选项），它绕过 Composer 加载机制，90% 的 class not found 都源于此
如果用的是 Docker 或远程解释器，确保 vendor/ 目录在容器内可读，且路径映射一致

覆盖率数据不依赖你写了多少 assert，而依赖两个硬条件：是否用 Run with Coverage 启动，以及 CLI PHP 是否启用了 Xdebug。

右键测试 → 一定要选 Run ‘ExampleTest’ with Coverage（不是普通 Run）
Settings → Tools → Coverage → Coverage runner 必须设为 Xdebug（即使你实际用 PCOV，PhpStorm 当前版本仍只认 Xdebug 作为驱动）
终端执行 php -v，输出里必须含 with Xdebug；没有就说明 CLI 模式下 Xdebug 未启用
Laravel 项目默认在 phpunit.xml 里配了 <whitelist></whitelist>，但如果你删了或改了路径，请确认 <directory></directory> 指向的是源码目录（如 app/），不是 tests/