sublime text 无法直接调试 phpunit 测试，仅能通过插件调用命令行执行；真要断点调试需配合 cli 模式 xdebug 与外部 ide（如 vs code、phpstorm），sublime 仅作为触发器和代码导航工具。
能直接在 Sublime Text 里跑 PHPUnit 测试，但默认不支持调试（断点、变量查看等）——它只负责调用命令行执行 phpunit，不接入 Xdebug 的调试协议。真要调试单个测试方法，得绕道 CLI + Xdebug + IDE 调试器配合，Sublime 本身只是触发器。
确认 phpunit 命令可用且版本匹配
Sublime 插件（如 sublime-phpunit）本质是调用系统 PATH 中的 phpunit 命令。如果报错 command not found 或版本太低（比如项目要求 PHPUnit 9+，而全局装的是 7.x），所有后续操作都会失败。
- 终端执行
which phpunit（macOS/Linux）或where phpunit（Windows），确认路径存在 - 运行
phpunit --version，检查是否 ≥ 项目要求的最低版本（常见坑：Composer 全局安装的phpunit/phpunit是旧版，而项目vendor/bin/phpunit才是新版） - 若路径不对，不要改 Sublime 的 Build System——
sublime-phpunit插件不走 Build System，它自己找phpunit；应把vendor/bin加入系统 PATH，或软链到全局可执行位置
安装 sublime-phpunit 并验证配置路径
这个插件会自动向上扫描目录树找 phpunit.xml 或 phpunit.xml.dist，再从该目录下执行 phpunit。但它不会读取 Composer 的 autoloader，也不识别 tests/bootstrap.php 里的自定义设置——除非你显式在 phpunit.xml 里声明了 bootstrap 属性。
- 用 Package Control 安装
sublime-phpunit，重启 Sublime - 确保项目根目录有
phpunit.xml（哪怕只有最简结构），否则插件会 fallback 到/目录执行，大概率失败 - 右键测试文件 →
Run PHPUnit Test，观察 Sublime 底部状态栏是否显示“Running PHPUnit…”；失败时看 Console（Ctrl+`）输出的完整命令和错误，重点看工作目录和phpunit调用路径
想调试单个 testMethod？别依赖 Sublime 界面操作
Sublime 没有内置 PHP 调试器，sublime-phpunit 更不支持断点。所谓“调试”，实际是让 Xdebug 在 CLI 模式下监听，再由外部工具（如 VS Code、PHPStorm 或命令行 php -dxdebug.mode=debug -dxdebug.start_with_request=yes vendor/bin/phpunit tests/ExampleTest.php）接管。
- 先确认 CLI 模式 Xdebug 已启用：终端运行
php -m | grep xdebug，再执行php -i | grep "xdebug.mode"，输出应含debug - CLI 下 Xdebug 默认不监听，需加参数启动：例如
php -dxdebug.mode=debug -dxdebug.client_host=127.0.0.1 -dxdebug.client_port=9003 vendor/bin/phpunit tests/ExampleTest.php::testSomething - Sublime 只能帮你快速打开对应测试文件、跳转到方法，不能设断点；真正调试请切到支持 Xdebug 的 IDE，或用
var_dump()+die()临时打点
常见失败信号和速查点
右键菜单没反应、状态栏卡住、Console 报 PHP Fatal error: Class 'PHPUnit\Framework\TestCase' not found —— 这些都不是 Sublime 的问题，而是环境链路断了。
-
Class not found：Composer autoloader 没加载，检查phpunit.xml的bootstrap是否指向vendor/autoload.php，或项目没运行过composer install - 状态栏一直显示 “Running…”：可能是
phpunit进程卡死，或 Xdebug 配置里xdebug.start_with_request被设为yes但无人监听，导致 CLI 挂起 - 测试通过但没输出：Sublime 的 panel 默认截断长输出，按
Ctrl+Shift+P→ 输入SublimePHPUnit: Toggle Output Panel手动展开看全量结果
真正卡住的地方往往不在 Sublime 设置里，而在 phpunit.xml 的路径配置、Composer autoload 的生效范围、以及 CLI 模式下 Xdebug 的开关逻辑——这三个点对齐了，Sublime 才是个称手的触发开关，而不是黑盒调试器。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
