VSCode调试PHP 8.3.32需严格匹配Xdebug 3.4+（TS/VC17/x64），先验证php -v与php --ini路径，再通过Xdebug Wizard获取精准DLL及php.ini配置，最后在launch.json中正确设置port和pathMappings映射服务器实际路径。
要在 Windows 10 上为 PHP 8.3.32 配置 Xdebug 并实现 VSCode 调试，关键不是“装上就通”，而是每一步都严格匹配版本与路径。PHP 8.3 默认不再支持 Xdebug 2，必须使用 Xdebug 3.4+，且需确认是 TS（线程安全）+ VC17 + x64 版本——这三项缺一不可。
确认 PHP 环境已就绪
打开命令提示符或 PowerShell，执行：
-
php -v—— 必须显示 8.3.32，且不是系统默认的旧版（如 C:\Windows\System32\php.exe） -
php --ini—— 记下 Loaded Configuration File 路径，后续修改的就是这个php.ini -
php -m | findstr xdebug—— 初次应无输出（说明尚未加载）
下载并启用正确版本的 Xdebug
别用 pecl 或手动编译。直接访问 xdebug.org/download，按以下顺序操作：
- 运行
php -i，复制全部输出，粘贴到 Xdebug Wizard 页面（xdebug.org/wizard） - 它会精准给出 DLL 下载链接和 php.ini 配置项（例如：
php_xdebug-3.4.5-8.3-vc17-x64.dll） - 下载后，将 DLL 放入 PHP 的
ext/目录（如E:\php\83\ext\） - 在
php.ini末尾添加（注意路径用正斜杠或双反斜杠）：
xdebug.mode = debug xdebug.start_with_request = yes xdebug.client_host = 127.0.0.1 xdebug.client_port = 9003 zend_extension = E:/php/83/ext/php_xdebug-3.4.5-8.3-vc17-x64.dll
保存后，重启 Web 服务（如 Apache/Nginx）或 PHP-FPM，并再次运行 php -m | findstr xdebug 验证是否加载成功。
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
立即学习“PHP免费学习笔记（深入）”；
VSCode 中配置调试环境
确保已安装官方扩展：PHP Debug（由 Felix Becker 维护，ID：felixfbecker.php-debug）。
- 项目根目录创建
.vscode/launch.json，内容如下（适用于 Apache/Nginx 或 Wamp/BtPanel 等外部服务器）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html/": "${workspaceFolder}/"
}
}
]
}
重点说明 pathMappings：
左侧是服务器中 PHP 实际解析的绝对路径（如 Wamp 默认是 E:/wamp64/www/，宝塔是 E:/BtSoft/wwwroot/default/），右侧是本地项目文件夹。务必一一对应，否则断点不命中。
- 在 VSCode 中按
Ctrl+Shift+D打开调试面板，选择 Listen for Xdebug，点击绿色 ▶ 启动监听 - 浏览器中访问你的脚本（如
http://localhost/index.php），同时确保已安装 Xdebug Helper 插件并设为 Debug 模式
常见卡点与修复
-
VSCode 报 “Command 'php' not found”：说明 GUI 启动时未读取 PATH。请从终端执行
code .启动 VSCode -
断点灰色、不触发：90% 是
pathMappings错误，或 PHP 脚本实际运行路径与配置不一致（例如 ThinkPHP 必须指向public/目录） -
连接被拒绝 / timeout：检查 Windows 防火墙是否放行端口 9003；确认
xdebug.client_host是127.0.0.1（非 localhost） -
调试时变量为空或无法展开：在 php.ini 中补充
xdebug.var_display_max_depth=10和xdebug.max_nesting_level=512
