phpstorm如何使用单元测试PHPUnit（代码测试指南）-phpstorm-PHP中文网

必须配置Composer自动加载器：进入Settings → Tools → PHP → Test Frameworks，点击+选择“PHPUnit by Composer autoloader”，在Path to autoloader中填写项目根目录下的vendor/autoload.php绝对路径，不可填phpunit.phar或vendor/bin/phpunit。

phpstorm如何使用单元测试phpunit（代码测试指南）

PhpStorm 找不到 `PHPUnitFrameworkTestCase` 怎么办

不是 PHPUnit 没装，是 PhpStorm 没连上自动加载器。它根本没机会去加载那个类。

必须进 Settings → Tools → PHP → Test Frameworks，点 + → 选 PHPUnit by Composer autoloader，然后在 Path to autoloader 栏填 vendor/autoload.php（绝对路径，不能是 phpunit.phar 或 vendor/bin/phpunit）。

填错成 vendor/bin/phpunit 或 phpunit.phar：会报 Class 'PHPUnitFrameworkTestCase' not found，因为那俩是执行入口，不是加载器
项目用的是 Composer 全局安装（composer global require phpunit/phpunit）：别选 Global installation，它大概率找不到 autoload.php；坚持用项目级 vendor/autoload.php
刚 composer require --dev phpunit/phpunit 完但还没生成 vendor/autoload.php：先跑一次 composer install 或 composer dump-autoload -o

右键 Run ‘Tests in xxx’ 没反应或报 `Class "TestsUnitExampleTest" could not be found`

这是 PSR-4 自动加载断了，和 PhpStorm 配置关系不大，得查你自己的 composer.json 和文件路径。

假设测试类声明 namespace TestsUnit;，那它必须放在 tests/Unit/ExampleTest.php，且 composer.json 的 autoload-dev 要映射对：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

"autoload-dev": {
    "psr-4": {
        "Tests\": "tests/"
    }
}

改完 composer.json 后不运行 composer dump-autoload -o：PhpStorm 和 CLI 都不会识别新类
tests/ 目录没被标记为测试根：右键该目录 → Mark Directory as → Test Sources Root（图标变绿才算生效）
文件名大小写不一致（比如类叫 ExampleTest，文件存成 exampletest.php）：Linux/macOS 下直接加载失败，Windows 可能侥幸通过但不可靠

为什么 `phpunit.xml` 写好了却不起作用

PhpStorm 不扫描子目录，只认项目最顶层（你打开的那个文件夹）下的 phpunit.xml 或 phpunit.xml.dist，一个字母都不能错。

文件不在根目录：比如放在 config/phpunit.xml，PhpStorm 就当它不存在
没右键标记：即使文件存在，也得右键它 → Mark as PHPUnit Configuration File；没这选项？检查 PHP 插件是否启用（Settings → Plugins 里搜 PHP）
文件内容无效：开头必须是根节点，不能只有；至少要有或
用了自定义配置但没勾选 Use custom configuration file：在 Test Frameworks 设置里要手动指定路径

覆盖率显示 0%，Xdebug 明明开着也没用

两个硬性条件缺一不可：一是 CLI PHP 真启用了 Xdebug（php -m | grep xdebug 有输出），二是 PhpStorm 必须用 Run with Coverage 启动，且设置里选对驱动。

普通右键 Run 不会收集覆盖率数据，必须选 Run with Coverage（右键菜单或快捷键 Ctrl+Shift+F9）
Settings → Tools → Coverage 中的 Coverage runner 必须设为 Xdebug —— 即使你实际用的是 PCOV，PhpStorm 当前版本（2026 年）仍只认 Xdebug 作为覆盖率后端
Xdebug 3 需确认 xdebug.mode=coverage（不是 debug 或 develop），且 xdebug.start_with_request=trigger 或 yes

最常被忽略的一点：所有路径都依赖真实文件系统结构，而不是“看起来像”。比如 vendor/autoload.php 路径写错一位、tests/ 没标为测试根、phpunit.xml 放错目录层级——这些都不会报明确错误，只会静默失效。验证时优先用终端命令 ./vendor/bin/phpunit tests/ExampleTest.php 看是否能跑通，再回头调 IDE。