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 -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