PHP单元测试在VS Code中运行失败，需先确保phpunit命令行可用；再正确配置tasks.json路径、安装PHP Test Explorer插件；调试需xdebug.mode=debug且launch.json匹配ideKey；PATH未加载时用终端启动code .。
PHP单元测试在VS Code里跑不起来？先确认你装的是哪个测试框架
VS Code本身不运行PHP测试，它只是调用你本地配置的测试工具。最常见的是phpunit，但也有用pest或codeception的。如果你执行phpunit --version报错，说明根本没装好——别急着配VS Code，先让命令行能跑通。
- 全局安装（推荐初学者）：
composer global require phpunit/phpunit
并确保~/.composer/vendor/bin（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）已加入系统PATH - 项目本地安装（更安全）：
composer require --dev phpunit/phpunit
，之后VS Code必须识别到项目根目录下的vendor/bin/phpunit - 检查是否可用：
phpunit --version
输出版本号才算过关
VS Code里点“运行”没反应？检查tasks.json和launch.json的路径写法
VS Code靠tasks.json定义怎么执行测试，靠launch.json决定是否调试。很多人卡在路径上——特别是Windows用户用反斜杠\或没转义空格。
-
tasks.json中command字段必须是可执行的完整路径，比如："command": "${config:php.executablePath}",或直接写"command": "php"（前提是php在PATH中） -
args里传phpunit时，别写成"./vendor/bin/phpunit"——Windows不认识./，改用"${workspaceFolder}/vendor/bin/phpunit"（Linux/macOS也兼容） - 如果项目用了自定义
phpunit.xml，务必在args里显式加："--configuration", "${workspaceFolder}/phpunit.xml"
右键菜单没有“Run Test”？你缺了PHP Test Explorer插件
VS Code默认不识别test文件夹或*Test.php命名规则。官方PHP扩展只提供语法支持，不带测试集成。必须装PHP Test Explorer（作者：rebornix）。
- 安装后重启VS Code，它会自动扫描
tests/目录和*Test.php文件 - 如果没扫描出来，点侧边栏“测试”图标 → 齿轮图标 → 选
PHPUnit→ 手动填phpunit路径（比如vendor/bin/phpunit或全局路径） - 注意：该插件依赖
phpunit能被VS Code终端识别，所以PATH问题必须先解决 - 运行单个测试方法时，它实际执行的是类似
phpunit --filter testCanAddNumbers tests/CalculatorTest.php这样的命令
断点调试PHP测试进不去？xdebug.mode=debug和idekey要对得上
能运行≠能调试。PHP调试依赖xdebug，而xdebug 3.x之后必须显式开启debug模式，且VS Code的launch.json里ideKey要和PHP配置一致。
立即学习“PHP免费学习笔记（深入）”；
- 检查
php -v输出里有没有xdebug，再运行php -i | grep xdebug.mode，确认值是debug（不是off或develop） -
launch.json中必须有："type": "php", "request": "launch", "port": 9003", "pathMappings": { "/var/www/html": "${workspaceFolder}" }（Docker环境路径映射容易错） - 如果用PHP内置服务器跑测试（比如
php -S localhost:8000），记得加-d xdebug.mode=debug -d xdebug.start_with_request=yes
phpunit命令本身在终端能跑、在VS Code里却报“command not found”——这几乎100%是VS Code没读取到你的shell配置（比如~/.zshrc里的PATH）。关掉所有VS Code窗口，从终端执行code .启动，问题通常就消失。 
