trae中zend_extension必须用绝对路径，因内置PHP不支持相对路径或动态解析；需手动复制预编译.so到extension_dir并写死路径，确保ABI匹配且置于php.ini顶部，reload后须kill残留php-fpm进程。
trae 中 PHP 的 zend_extension 加载路径必须是绝对路径
trae 默认使用内置 PHP（通常为 8.1+），但它的 php.ini 加载机制不支持相对路径或 extension_dir 的动态解析来定位 zend_extension。如果你写 zend_extension=opcache.so 或 zend_extension=./xdebug.so，PHP 启动时会静默失败——php -m 看不到，phpinfo() 里也无痕迹，连错误日志都不报。
实操建议：
- 先用
trae php --ini找到实际生效的php.ini路径（通常是~/.trae/php/php.ini） - 用
php -r "echo ini_get('extension_dir');"查出 PHP 编译时的默认扩展目录（如/usr/lib/php/20250902） - 把你的
.so文件（如xdebug.so、opcache.so）复制进去，或用绝对路径直接写死：zend_extension=/usr/lib/php/20250902/xdebug.so
- trae 不读取系统全局
php.ini，只认它自己管理的那份，改错文件无效
trae 的 PHP 是静态编译的，不能用 pecl install 直接装 zend 扩展
trae 自带的 PHP 二进制是精简打包版，没带 phpize、pecl 或 pkg-config 支持，执行 pecl install xdebug 会卡在找不到 php-config 或报 configure: error: Cannot find php-config。
替代方案只有两个：
- 手动下载对应 PHP 版本和 ABI 的预编译
.so（例如 Xdebug 官网的xdebug-3.2.2-php-8.1-nts-x86_64-linux.so） - 或从 Ubuntu/Debian 的
php-xdebug包里提取：dpkg -x /var/cache/apt/archives/php-xdebug_*.deb /tmp/xdebug-extract，再找.so文件 - 注意 ABI 匹配：用
php -r "echo PHP_ZTS ? 'ZTS' : 'NTS'; echo '-' . PHP_INT_SIZE * 8;"确认是 NTS/64bit 还是 ZTS/64bit
zend_extension 必须放在 php.ini 靠前位置，且不能和 extension= 混用同一行
PHP 解析 php.ini 是顺序执行的，zend_extension 涉及 Zend 引擎底层 Hook，必须在任何普通扩展（如 extension=mysqli）之前加载。如果写成：
extension=mysqli.so zend_extension=xdebug.so
Xdebug 可能初始化失败，导致断点无效或 php -v 报 Segmentation fault。
正确写法（顶部附近）：
zend_extension=/usr/lib/php/20250902/xdebug.so ; 其他 extension=... 放在这后面
另外，zend_extension 不接受逗号分隔多个值，也不能写成 zend_extension="a.so,b.so" —— 每个必须单独一行。
trae reload 后 PHP 进程未必真正重启，得杀干净残留进程
trae 做 trae restart 或 trae reload 时，旧的 PHP-FPM worker 进程可能还在跑，导致你改了 php.ini、加了 zend_extension，但 phpinfo() 里还是看不到。这不是配置问题，是进程没换。
检查并清理方法：
- 运行
ps aux | grep php-fpm，看有没有老 master 进程（UID 是你当前用户，不是 root） - 手动 kill：
pkill -u $USER php-fpm，再trae start - trae 的日志在
~/.trae/logs/php-fpm.log，启动失败时重点看这行：failed to load Zend extension '—— 如果有，说明路径或 ABI 错了
ABI 不匹配是最隐蔽的问题：哪怕文件存在、路径对、权限 755，只要 php -v 不报错但扩展不生效，十有八九是 ZTS/NTS 或主版本号（8.1 vs 8.2）对不上。
