Sublime Text需通过插件和正确配置才能运行PHPUnit：先确保终端中phpunit --version可用，再配置专用Build System并设working_dir为$project_path，最后关联*Test.php语法高亮。
Sublime Text 本身不内置 PHPUnit 支持，必须通过插件 + 正确路径配置才能运行测试，否则会报 phpunit: command not found 或 Class 'PHPUnit\Framework\TestCase' not found。
安装 PHPUnit 并确认命令行可用
Sublime 调用的是系统 shell 中的 phpunit 命令，不是 Composer vendor 目录下的脚本（除非你显式配置了完整路径）。所以第一步永远是：确保终端里能直接敲 phpunit --version 成功返回版本号。
- 推荐用 Composer 全局安装：
composer global require phpunit/phpunit，然后把~/.composer/vendor/bin加进系统$PATH - 如果项目级安装（
composer require --dev phpunit/phpunit），则必须在 Sublime 构建系统中指定完整路径，例如：./vendor/bin/phpunit（Linux/macOS）或vendor\bin\phpunit.bat（Windows） - PHP 版本需匹配 PHPUnit 版本，比如 PHPUnit 9.x 要求 PHP 7.3+；用
php -v和phpunit --version对照检查
配置 Sublime 的 Build System（关键步骤）
Build System 决定 Sublime 怎么调用 PHPUnit。不能只改菜单里的“PHP”，必须新建一个专用构建配置，否则默认不会识别 *Test.php 文件或自动传参。
- 菜单栏选择 Tools → Build System → New Build System，粘贴以下内容（根据系统微调）：
{
"cmd": ["phpunit", "$file"],
"selector": "source.php",
"working_dir": "$project_path",
"variants": [
{
"name": "Run All Tests",
"cmd": ["phpunit", "tests/"]
},
{
"name": "Run Current Test Class",
"cmd": ["phpunit", "--filter", "^test.*$", "$file_base_name"]
}
]
}
-
"cmd"中的phpunit必须能在 shell 中直接执行；若不行，换成绝对路径，如"/usr/local/bin/phpunit" -
"working_dir"设为$project_path很重要——否则phpunit.xml可能加载失败，导致 bootstrap 或配置项失效 - 保存为
PHPUnit.sublime-build，之后在 Tools → Build System 下就能选中它
让 Sublime 正确识别测试文件和断点调试
默认 Sublime 不知道 *Test.php 是测试文件，也不会高亮 assertTrue() 这类断言。这不是功能缺失，而是没关联语法和作用域。
立即学习“PHP免费学习笔记（深入）”；
- 右下角点击当前语法（如 “PHP”），选择 Open all with current extension as… → PHP，确保
.php和*Test.php都走 PHP 语法高亮 - 如果使用
phpunit.xml，确认它放在项目根目录，并包含<testsuites>和<bootstrap>（如有自定义 autoload） - 想调试单个测试方法？Sublime 本身不支持 PHPUnit 断点，但可配合
xdebug+php -dxdebug.mode=debug -dxdebug.start_with_request=yes vendor/bin/phpunit --filter testMethod手动触发
最常被跳过的其实是 working_dir 和 phpunit 可执行路径——这两项错一个，构建就静默失败或报错找不到测试类。别依赖“看起来能跑”，每次换项目、升级 PHP 或重装 Composer 后，都建议在终端 cd 到项目根目录，手动跑一遍 phpunit tests/ExampleTest.php 确认基础通路。
