VSCode调试PHPUnit必须配置launch.json中"program": "${workspaceFolder}/vendor/bin/phpunit"、"args": ["${file}"]、"cwd": "${workspaceFolder}"，并设"env": {"XDEBUG_MODE": "debug"}，同时确保php.executablePath指向含Xdebug的PHP绝对路径。
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 设置中搜索
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免费学习笔记（深入）”；
- 检查
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类路径可能出错
最常被忽略的是 php.executablePath 和 env.XDEBUG_MODE 的双重校验——它们不在同一层，但缺一不可。Xdebug 3.x 的 mode 机制让配置更明确，但也更不容错。
