PHP 8.0+ 必须改用 Sdebug 而非 Xdebug，因 Xdebug 3.x 已停止维护 Windows TS 版本，无法兼容 PHP 8.1+ 的 Zend 引擎重构；Sdebug 3.5+ 是唯一官方支持 PHP 8.0～8.4（TS/NTS）的调试扩展，需严格匹配 PHP 架构、使用 sdebug. 前缀配置并启用 sdebug.log 调试日志。
PHP 8 系统中无法直接用 Xdebug 调试，是因为它不兼容 PHP 8.0+ 的 ZTS（Zend Thread Safety）变更；必须改用 Sdebug —— 这是目前唯一官方支持 PHP 8.0～8.4 的 Windows 调试扩展，且与 VS Code、PhpStorm 完全兼容。
为什么不能继续用 Xdebug 而要换 Sdebug
PHP 8.0 起彻底重构了 Zend 引擎的内存模型和调试钩子机制。Xdebug 3.x 在 PHP 8.1 后停止维护 Windows TS 版本，而 Sdebug 是由国内团队基于 PHP 官方调试 API（zend_execute_ex hook + zend_compile_file 替换）重写的替代方案，专为 PHP 8 的线程安全模式设计。
- 错误现象：
PHP Warning: Xdebug: Unable to register functions, invalid engine version - 根本原因：Xdebug 加载时检测到 PHP 8.2+ 的
ZEND_MODULE_API_NO不匹配，拒绝初始化 - 兼容性确认：Sdebug 3.5+ 明确标注支持
PHP 8.0/8.1/8.2/8.3/8.4 (TS)，官网下载页有对应 VC 版本（如 VS16 x64）和 NTS/TS 标识
下载与放置 Sdebug DLL 文件
关键不是“下哪个包”，而是“下对架构”——必须和你的 PHP 运行模式严格一致。WAMP、phpStudy、XAMPP 等集成环境默认用 TS 模式，所以必须选带 (TS) 标识的版本。
- 去 Sdebug 官网下载页（注意不是 xdebug.org），找
Windows downloads区域 - 根据你的 PHP 版本选包，例如 PHP 8.3.7 → 下载
sdebug-3.5.1-8.3-vc16-x64-ts.dll - 把 DLL 放进 PHP 的
ext目录，路径类似：C:\wamp64\bin\php\php8.3.7\ext\sdebug.dll - 不要重命名文件，Sdebug 不接受
php_sdebug.dll或php_xdebug.dll这类别名
php.ini 中启用 Sdebug 的最小必要配置
配置项名称和语义与 Xdebug 不同，照搬旧配置会静默失效。Sdebug 使用 sdebug. 前缀，且必须用 zend_extension 加载（不是 extension）。
立即学习“PHP免费学习笔记（深入）”；
zend_extension="C:/wamp64/bin/php/php8.3.7/ext/sdebug.dll" sdebug.enable=1 sdebug.idekey="VSCODE" sdebug.client_host=127.0.0.1 sdebug.client_port=9003 sdebug.log="C:/wamp64/logs/sdebug.log" sdebug.log_level=7
-
sdebug.client_port默认是9003，不是 Xdebug 的9000或9001，VS Code 的launch.json必须同步改 -
sdebug.log_level=7才能输出完整连接日志，排查“断点不命中”时必开 - 如果用 phpStudy，还需在软件界面勾选该扩展，否则即使 ini 配置正确也不会加载
VS Code 断点调试启动失败的三个高频原因
配置完 php.ini 并重启 Apache 后，仍无法触发断点，大概率卡在这三处：
- VS Code 的
launch.json中port写成9000，实际应为"port": 9003 - 没在浏览器 URL 后加
?XDEBUG_SESSION_START=vsc（或使用官方插件Xdebug Helper），Sdebug 不支持start_with_request=yes这种自动触发模式 - PHP 进程未真正加载 Sdebug：运行
php -m | findstr sdebug（Windows）或php -m | grep sdebug（Linux/macOS），无输出说明 DLL 路径错或版本不匹配
最易被忽略的是：Sdebug 的日志默认不写入任何位置，sdebug.log 路径必须是 PHP 进程有写权限的目录，且父目录需真实存在——否则连日志都看不到，问题就永远卡在“不知道哪错了”。
