PHP 7.3 的 Xdebug 必须手动编译 Xdebug 2.9.8 并严格匹配 ABI 标识（如 no-debug-non-zts-20180731），宝塔一键安装无效；需用 php-config 指定路径编译，正确配置 zend_extension 路径及 remote 参数，并确保文件权限为 rw-r--r--，最后通过 Xdebug Helper 插件主动触发调试。
PHP 7.3 的 Xdebug 在宝塔面板里不能直接点开就用，核心原因是宝塔默认安装的 xdebug.so 是为 PHP 7.4+ 编译的，7.3 对应的扩展需要手动编译或替换，否则会报 undefined symbol: zend_string_release_ex 这类符号缺失错误。
确认当前 PHP 7.3 的实际编译参数和架构
宝塔的 PHP 管理界面不显示完整 configure 参数，但 Xdebug 编译必须严格匹配。漏掉这点，90% 的失败都发生在这里。
- 登录服务器，执行：
php -i | grep "Configure Command"，复制整行输出 - 再运行：
php -v和php-config --prefix，确认是 7.3.x 版本及安装路径（通常是/www/server/php/73） - 特别注意：如果看到
--enable-fpm但没--with-libdir=lib64，说明是 64 位系统但用了 32 位库路径，后续编译时./configure必须加对应参数
下载并编译兼容 PHP 7.3 的 Xdebug 2.9.8
Xdebug 3.x 不支持 PHP 7.3，官方已明确终止支持；Xdebug 2.9.8 是最后一个兼容 7.3 的稳定版，且必须源码编译——宝塔软件商店里的“一键安装”对 7.3 无效。
- 进 PHP 7.3 源码目录（如
/www/server/php/73/src），或重新下载对应版本源码：wget https://windows.php.net/downloads/releases/php-7.3.33.tar.gz - 解压后进入
ext/xdebug目录，执行：phpize && ./configure --enable-xdebug --with-php-config=/www/server/php/73/bin/php-config - 若报错
aclocal-1.14 is missing，先装 automake：yum install automake autoconf（CentOS）或apt install automake autoconf（Ubuntu） -
make && make install成功后，会输出类似Installing shared extensions: /www/server/php/73/lib/php/extensions/no-debug-non-zts-20180731/
配置 php.ini 并验证加载
别直接改宝塔界面里的“配置修改”，它会自动重写，覆盖你手写的 Xdebug 配置段。必须进文件系统编辑原始 php.ini。
立即学习“PHP免费学习笔记（深入）”；
- 打开
/www/server/php/73/etc/php.ini，在文件末尾追加：
[xdebug] zend_extension = /www/server/php/73/lib/php/extensions/no-debug-non-zts-20180731/xdebug.so xdebug.remote_enable = 1 xdebug.remote_host = 127.0.0.1 xdebug.remote_port = 9000 xdebug.remote_handler = dbgp xdebug.remote_mode = req xdebug.remote_autostart = 1 xdebug.idekey = PHPSTORM
- 关键点：
zend_extension路径必须和make install输出的一致；no-debug-non-zts-20180731是 PHP 7.3.0–7.3.x 的 ABI 标识，写错会导致启动失败 - 重启 PHP：
service php-fpm-73 restart（不是宝塔面板里的“重载配置”） - 执行
php -m | grep xdebug，有输出即加载成功；再跑php -i | grep xdebug看是否显示全部配置项
IDE 端调试前必做的三件事
即使 PHP 端全通，IDE 侧一个疏忽就会卡在“waiting for connection”。重点不是配端口，而是配触发逻辑。
- PHPStorm：Settings → PHP → Servers，Host 填你访问网站的实际域名（如
test.local），不要填localhost；Path Mapping 必须把本地项目路径映射到服务器上的绝对路径（如/www/wwwroot/test） - 浏览器装 Xdebug Helper 插件，右键点击图标 → Debug，确保请求头带上
XDEBUG_SESSION_START=PHPSTORM - 别依赖
xdebug.remote_autostart=1：它对 CLI 有效，但对 Nginx/FPM 请求常因超时被丢弃；务必主动触发（插件点一下，或 URL 加?XDEBUG_SESSION_START=PHPSTORM）
最常被跳过的细节：宝塔的 PHP-FPM 进程默认以 www 用户运行，而 xdebug.so 文件权限若为 root 所有、无 group/o 可读，就会静默失败——检查 ls -l /www/server/php/73/lib/php/extensions/.../xdebug.so，确保是 rw-r--r--。
