xdebug 3.x+是php 8.0+唯一兼容版本，需用xdebug.mode=debug等新参数，旧配置会导致启动失败；必须重启php进程（非重载）、检查.so路径与php.ini严格匹配，并通过xdebug.log排查连接问题。
Xdebug 在宝塔 PHP 8.0+ 上默认不启用，且旧版配置（如 xdebug.remote_enable）会直接导致 PHP 启动失败——必须用 Xdebug 3.x+ 配置方式，否则改完 php.ini 后宝塔会自动禁用该 PHP 版本。
确认 Xdebug 是否已正确安装并加载到目标 PHP 版本
宝塔每个 PHP 版本是独立环境，系统级或其它 PHP 版本装的 Xdebug 对当前版本完全无效。不能只看「软件商店」里勾选了就认为成功。
- 登录服务器终端，执行：
sudo -u www /www/server/php/80/bin/php -m | grep xdebug—— 若无输出，说明未加载 - 若有输出但报错
Invalid configuration directive 'xdebug.mode'，说明装的是 Xdebug 2.x，与 PHP 8.0 不兼容，必须卸载重装 3.1+ - 宝塔后台「软件商店 → PHP-8.0 → 管理 → 安装扩展」里勾选 Xdebug 后，仍需检查实际生成的
.so文件是否存在：/www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/xdebug.so - 若路径中目录名是
no-debug-zts-20200930或其他变体，extension_dir值和zend_extension路径必须严格匹配，否则 PHP 启动时静默忽略
php.ini 中必须用 Xdebug 3 的新参数，旧参数会破坏启动
Xdebug 3 彻底废弃 xdebug.remote_* 系列配置，写进去不仅无效，还会让宝塔检测到非法指令，自动禁用该 PHP 实例。
- 在
/www/server/php/80/etc/php.ini末尾添加以下段落（注意是[xdebug]小节，不是注释掉的旧配置）： zend_extension = /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/xdebug.so-
xdebug.mode = debug—— 必须显式设置，缺省值为空，不设则断点完全不触发 -
xdebug.start_with_request = trigger—— 推荐设为trigger，通过 URL 加?XDEBUG_SESSION_START=PHPSTORM控制，避免全站请求都连 IDE 拖慢响应 -
xdebug.client_host = 127.0.0.1—— 宝塔本地部署时填这个；若 PHP 在 Docker 容器中，此处必须填宿主机真实 IP（host.docker.internal在宝塔下不可用） -
xdebug.client_port = 9003—— PhpStorm/VS Code 默认端口，不是 9000；确保防火墙放行出站（非入站）9003 -
xdebug.log = /tmp/xdebug.log—— 强烈建议开启，连接失败时直接查日志，比反复猜配置快得多
重启与验证必须走对路径，重载 ≠ 重启
宝塔界面里「重载配置」只会重新读取 php.ini，但不会重新加载 Zend 扩展；Xdebug 是 Zend 扩展，必须完整重启 PHP 进程才能生效。
- 改完
php.ini后，必须进宝塔后台 → 「软件商店 → PHP-8.0 → 重启」按钮（不是「重载配置」） - 重启后执行：
sudo -u www /www/server/php/80/bin/php -v，输出中应含with Xdebug v3.x.x - 再执行：
sudo -u www /www/server/php/80/bin/php -i | grep xdebug.mode，确认输出为xdebug.mode => debug - 访问一个 PHP 页面，加上
?XDEBUG_SESSION_START=PHPSTORM，同时打开 IDE 监听，再看/tmp/xdebug.log是否有Connection established日志行
最容易被忽略的是：Xdebug 3 的 xdebug.mode 是多模式开关，debug 和 develop 是互斥的；只设 develop 不会触发断点，必须显式包含 debug。另外，宝塔下 client_host 填错 IP 或端口不通时，PHP 进程会默默放弃连接，没有任何错误提示——全靠 xdebug.log 说话。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
