如何阻止VS Code在无断点处自动暂停PHP调试？

先检查调试配置文件（launch.json） #

打开.vscode/launch.json，重点调整这几个配置项：

• 将stopOnEntry设为false：这个选项控制调试启动时是否自动停在代码第一行，默认可能开启，关闭后就不会一启动调试就暂停。
• 调整异常捕获规则：stopOnExceptions如果设为true，调试器会在所有异常（包括警告、通知级别的小问题）触发时自动暂停，而Composer自动加载过程很容易触发这类场景。建议把它改成false，仅保留stopOnUncaughtExceptions为true（这个仅在真正未捕获的严重异常时暂停，不影响正常调试流程）。

配置示例片段：

{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "stopOnEntry": false,
    "stopOnExceptions": false,
    "stopOnUncaughtExceptions": true
}

排查Xdebug全局配置（php.ini） #

如果上面的配置没解决问题，可能是Xdebug本身的默认设置导致：

• 找到xdebug.default_enable，将其改为0：这个选项开启时，Xdebug会自动跟踪所有错误，哪怕是轻微警告也会触发调试器暂停。
• 把xdebug.show_exception_trace设为0：避免自动弹出异常跟踪信息导致调试器暂停。

修改完成后重启PHP服务，配置才会生效。

针对__destruct()方法的特殊处理 #

如果仅在析构函数执行时出现自动暂停，大概率是析构过程中触发了小错误或警告。可以临时在析构函数中添加错误抑制：

public function __destruct() {
    // 临时屏蔽错误通知，防止调试器暂停
    error_reporting(0);
    // 你的析构逻辑代码
    // 调试完成后可恢复错误报告（可选）
    error_reporting(E_ALL);
}

注：这只是调试阶段的临时方案，生产环境不建议使用，需保留正常的错误报告机制。

最后验证断点列表 #

检查VS Code调试面板的「断点」栏，确认没有勾选「所有异常」「未捕获异常」这类异常断点。如果有，取消对应的勾选，只保留你手动设置的行断点即可。

内容的提问来源于stack exchange，提问作者Dennis