PhpStorm 远程运行 PHPUnit 本质是本地触发、远程执行，关键在于正确配置远程 PHP 解释器、指向远程 vendor/autoload.php、确保 vendor/bin/phpunit 存在且可执行、严格对齐命名空间与文件路径、正确设置 Xdebug CLI 模式及路径映射。
PhpStorm 无法直接“远程运行 PHPUnit”，它只支持在本地执行测试命令，但可通过远程 PHP 解释器调用服务器上的 php 和 vendor/bin/phpunit——本质是本地触发、远程执行。关键不是“配 PHPUnit”，而是让 PhpStorm 正确识别并使用远程环境里的 PHP + 自动加载 + 测试路径。
PHPUnit 远程运行必须用 Composer 安装到项目里
PhpStorm 不读全局 phpunit，也不支持填远程 phpunit.phar。它只认你项目 vendor/bin/phpunit（Linux/macOS）或 vendorphpunit.bat（Windows），且该文件必须由 Composer 在远程服务器上生成。
- 在远程服务器上进入项目根目录，运行
composer install --no-dev或composer install（确保phpunit/phpunit在require-dev中） - 确认远程存在
vendor/bin/phpunit：登录服务器后执行ls -l vendor/bin/phpunit，应为可执行脚本（非空、有 x 权限） - 不要手动上传
phpunit.phar到远程；PhpStorm 的 “Path to phpunit.phar” 栏位只接受 .phar 文件，填vendor/bin/phpunit会报错
PHP 解释器和 PHPUnit 库路径必须指向远程环境
Settings → PHP → CLI Interpreter 必须选中已配置的远程解释器（SSH 类型），且其 PHP 路径是远程服务器上的真实路径，例如 /usr/bin/php 或 /home/user/.phpbrew/php/8.2.12/bin/php。
- Settings → PHP → Test Frameworks → PHPUnit：选择 “Use Composer autoloader”，然后点右侧
...，导航到远程服务器上的vendor/autoload.php—— 注意不是本地路径，也不是phpunit.xml - 如果点不开远程路径，说明 SSH 配置未正确关联或权限不足；此时需先验证 Deployment 连接是否正常（View → Tool Windows → Deployment → Log）
- 不要勾选 “Use alternative configuration file” 并手动填远程
phpunit.xml路径；PhpStorm 只自动识别项目根目录下的phpunit.xml或phpunit.xml.dist，且仅当该文件存在于你用 PhpStorm 打开的项目根目录时才生效（大小写敏感）
测试类找不到？问题几乎都在自动加载和路径映射
报错 Class "TestsUnitExampleTest" could not be found，90% 是因为远程 Composer 没注册命名空间，或 PhpStorm 没把 tests/ 当作测试源目录。
立即学习“PHP免费学习笔记（深入）”；
- 检查远程
composer.json的autoload-dev是否包含类似"Tests\": "tests/"的映射；改完后必须在远程执行composer dump-autoload -o - 在 PhpStorm 中右键
tests/目录 → Mark Directory as → Test Sources Root（显示为绿色图标），否则 IDE 不扫描该目录下类 - 测试类文件路径必须与命名空间严格一致：如类声明
namespace TestsUnit;，则文件必须位于tests/Unit/ExampleTest.php；远程服务器大小写敏感，Tests/unit/会失败 - 确保远程
phpunit.xml顶层标签是<phpunit>，不是<?xml开头 —— 后者是 XML 声明，会导致解析失败
Xdebug 调试远程 PHPUnit 时断点不触发
远程运行 PHPUnit 时启用 Xdebug，断点进不去，通常不是配置没开，而是 CLI 模式未启用调试、或路径映射错位。
- 远程 PHP CLI 必须加载 Xdebug：在服务器上运行
php -m | grep xdebug，若无输出，说明 CLI 模式未启用（php.ini和php-cli.ini是两个文件） - Xdebug 3.x 禁用所有
xdebug.remote_*参数；只保留xdebug.mode=debug、xdebug.start_with_request=trigger、xdebug.client_host=127.0.0.1（直连）或xdebug.client_host=host.docker.internal（Docker） - PhpStorm 的路径映射（Settings → PHP → CLI Interpreter → Show all local paths）必须将本地项目根目录映射到远程部署路径（如
/var/www/myapp），否则 Xdebug 找不到源码位置，显示 “No executable code found” - 调试前务必点击 PhpStorm 右上角电话图标（Start Listening for PHP Debug Connections），端口需与
xdebug.client_port一致（默认 9003）
最易被忽略的一点：远程运行 PHPUnit 时，phpunit.xml 中的 bootstrap 路径、testSuite 的 directory 值，都必须是远程服务器上的绝对路径（如 /var/www/myapp/tests），而不是相对路径或本地路径。PhpStorm 不会帮你转译这些路径，它只把整个命令丢给远程 php 执行。
