VSCode配置PHPUnit测试框架自动化单元测试运行指南【详细】-VSCode-PHP中文网

vscode调试phpunit必须配置launch.json中"program": "${workspacefolder}/vendor/bin/phpunit"、"args": ["${file}"]、"cwd": "${workspacefolder}"，并设"env": {"xdebug_mode": "debug"}，同时确保php.executablepath指向含xdebug的php绝对路径。

vscode配置phpunit测试框架自动化单元测试运行指南【详细】

VSCode 调试 PHPUnit 必须显式配置 launch.json、启用 Xdebug 3.x 的 debug 模式、并指定 PHP 可执行路径——三者缺一不可，否则断点灰色、调试无响应或报 command 'php' not found。

launch.json 中 `program` 和 `args` 怎么写才有效

VSCode 不会自动推导 PHPUnit 入口，必须在 .vscode/launch.json 里明确定义调用链。常见错误是直接写 "program": "phpunit" 或漏掉 args 动态变量。

program 必须指向可执行的 vendor/bin/phpunit（不是全局命令），路径要相对于 ${workspaceFolder}
args 推荐用 ["${file}"]：只运行当前打开的测试文件，避免全量扫描；硬编码如 ["tests/CalculatorTest.php"] 会导致换文件后失效
cwd 必须设为 "${workspaceFolder}"：否则 Composer autoloader 找不到类，报 Class not found
不要加 --no-coverage 等参数到 args 里——PHPUnit 本身不认这个 flag，它是 phpunit.xml 控制的

`php.executablePath` 配置错会导致 “command 'php' not found”

VSCode 调试器启动的是全新进程，不继承终端 PATH。即使你在终端能跑 php --version，调试时仍可能失败。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在 VSCode 设置中搜索 php.executablePath，填入绝对路径，例如：/opt/homebrew/bin/php（macOS）、C:\php\php.exe（Windows）
如果项目用 asdf / phpenv 管理多版本 PHP，务必确认该路径指向已装 Xdebug 的那个版本
验证方式：在调试配置里临时加 "console": "integratedTerminal"，看启动时输出的 PHP 版本和 php --ini 结果是否一致

Xdebug 3.x 的 `xdebug.mode=debug` 和 `env.XDEBUG_MODE` 必须同时存在

只在 php.ini 里配了 xdebug.mode=debug 不够，VSCode 的 PHP Debug 扩展需要环境变量触发监听。

检查 php --ini 输出的 Loaded Configuration File，确保编辑的是 CLI 模式生效的 php.ini（不是 Apache/FPM 的）
该 php.ini 中必须有：zend_extension=xdebug.so + xdebug.mode=debug + xdebug.client_port=9003
launch.json 的 env 字段必须显式包含："XDEBUG_MODE": "debug"，否则断点永远灰色
若改过 Xdebug 监听端口（比如设成 9009），launch.json 还得同步加 "port": 9009

测试文件名与类名不匹配会报 “Cannot open file” 或 Class not found

PHPUnit 对命名敏感，VSCode 调试时不会帮你容错，路径解析失败就直接终止。

文件必须放在 tests/ 目录下（或你 phpunit.xml 里定义的 testSuite 路径）
文件名必须与类名严格一致：如类 class CalculatorTest → 文件名必须是 CalculatorTest.php，不能是 calculator_test.php 或 test_calculator.php
命名空间需与 composer.json 的 autoload 或 autoload-dev 匹配，且已执行过 composer install
如果用 phpunit.xml 自定义了 bootstrap，确保它被正确加载，否则 require_once 类路径可能出错