trae 中 extension=gd 不生效需确认三点：一是修改对应 PHP 版本（如 php81）的专属 php.ini（通过 trae php ini-path 查得），取消 ;extension=gd 注释或添加该行；二是重启 PHP-FPM（trae php-fpm restart）而非仅 trae restart；三是确保使用 -full 镜像以包含 libpng、libjpeg 等底层依赖。
trae 中 php.ini 里 extension=gd 加不生效？先确认 PHP 版本和模块路径
trae 默认使用的 PHP 是它内置的多版本环境（如 php74、php81），php.ini 文件位置不是系统全局路径，而是每个版本独立配置。直接改错 php.ini 或用系统命令装 gd 扩展完全无效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
trae php list查看当前启用的 PHP 版本（比如php81） - 执行
trae php ini-path php81获取该版本真实的php.ini路径（通常是~/.trae/php/php81/etc/php.ini） - gd 扩展在 trae 中默认已编译进 PHP，无需手动安装.so；只需确保没被注释且扩展名匹配
extension=gd 和 extension=gd.so 哪个对？看 PHP 版本和编译方式
trae 的 PHP 是静态编译（不是动态加载 .so），所以不能写 extension=gd.so —— 这会报 Unable to load dynamic library 'gd.so' 错误。正确写法是纯模块名，不带后缀。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 打开对应版本的
php.ini，搜索gd - 找到类似
;extension=gd的行，去掉分号，保存 - 如果找不到这行，手动添加
extension=gd在[PHP]段落下方（不要加路径，也不加.so） - 注意：PHP 8.0+ 默认启用 gd，但 trae 某些旧版镜像可能仍注释着，务必检查
重启 trae 后 php -m | grep gd 还是没输出？检查是否启用了正确的 PHP 版本
trae php use 切换的是 CLI 环境，而 web 请求走的是 trae 内置的 PHP-FPM 服务，两者配置文件可能不同 —— 这是最常被忽略的一点。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 执行
trae php-fpm restart（不是trae restart），强制重载 PHP-FPM 配置 - 用
trae php-fpm status确认服务已运行，再访问http://localhost/info.php（内容为<?php phpinfo(); ?>） - 在浏览器页面搜索
gd，确认 “GD Support” 显示 enabled，且 “GD Version” 有值（如bundled (2.1.0 compatible)） - 如果 CLI 的
php -m有 gd，但网页没有，说明 FPM 用的是另一份php.ini，重复第一步查路径
gd 库报 “Call to undefined function imagecreatefrompng()”？缺依赖库没装进容器
即使 extension=gd 生效，trae 的 PHP 容器若没预装 libpng、libjpeg、freetype 等底层库，gd 功能仍不完整 —— 图片创建/读取函数会直接报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进入容器验证：
trae exec php81 bash，然后运行ldd $(php-config --extension-dir)/gd.so | grep -i "png\|jpeg\|freetype" - 若输出中出现
not found，说明底层库缺失 - trae 目前不支持运行时 apt/yum 安装（容器只读），只能换镜像：在
~/.trae/config.yml中修改对应 PHP 版本的image字段，选带-full后缀的镜像（如traefik/php:8.1-apache-full） - 改完执行
trae php rebuild php81重建环境
