PHP 8.3+ 默认不内置 GD 扩展，需按系统匹配版本安装并手动启用：Linux 要用对应 phpX.Y-gd 包和 phpenmod 启用，CentOS/RHEL 需 remi 源，macOS 注意 PHP 路径一致性，Windows 必须 TS/NTS 和架构完全匹配 DLL，且依赖库须与 php.exe 同目录。
PHP 8.3+ 默认不内置 GD 扩展，必须显式安装并启用；仅靠 extension=gd 一行配置大概率失败——缺依赖、格式不支持、函数报错都是常见结果。
Linux（Debian/Ubuntu）用 apt 安装时注意 PHP 版本后缀
PHP 8.2、8.3 等新版不再共用 php-gd 包名，必须匹配当前 CLI 或 FPM 使用的版本：
- 先确认实际 PHP 版本：
php -v或php-fpm -v - 查可用包：
apt list --installed | grep php[0-9].[0-9]-gd - 安装示例（PHP 8.3）：
sudo apt install php8.3-gd - 关键点：安装后会自动生成
/etc/php/8.3/mods-available/gd.ini，但不会自动启用；需手动软链：sudo phpenmod -v 8.3 gd - 若用 Nginx + PHP-FPM，重启的是
php8.3-fpm，不是php-fpm（后者可能指向旧版）
CentOS/RHEL 8+ 和 AlmaLinux 9 必须用 dnf + remi 源
系统默认仓库只提供 PHP 8.0 的 php-gd，8.1+ 需启用第三方源：
- 启用 remi：
sudo dnf install epel-release && sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-9.rpm（RHEL 9/Alma 9） - 启用对应 PHP 版本模块：
sudo dnf module reset php && sudo dnf module enable php:remi-8.3 - 再安装：
sudo dnf install php-gd（此时安装的就是 8.3 版 GD） - 注意：
phpinfo()中显示的GD Version应为bundled (2.3.3)或更高，低于 2.3.0 可能缺失 WebP 支持
macOS 上 Homebrew 安装后仍看不到 GD？检查 PHP 路径是否一致
Homebrew 安装的 PHP（如 php@8.3）和系统自带 Apache 加载的 PHP 极易不一致：
立即学习“PHP免费学习笔记（深入）”；
- CLI 下运行
which php和php -r "echo php_ini_loaded_file();"查真实配置路径 - Web 环境下创建
info.php，重点看Loaded Configuration File行——它常指向/etc/php.ini（系统默认），而非 Homebrew 的/opt/homebrew/etc/php/8.3/php.ini - 解决方法：修改 Apache 的
httpd.conf，在LoadModule php_module后加一行：PHPIniDir "/opt/homebrew/etc/php/8.3" - 验证图像格式支持：
php -r "print_r(gd_info()['webp support']);"返回1才表示 WebP 可用（PHP 8.1+ + GD ≥ 2.3.0）
Windows 下 extension=gd 失效？大概率是 TS/NTS 或架构错配
PHP 8.2+ 官方 Windows 二进制包已分线程安全（TS）与非线程安全（NTS），GD 扩展 DLL 必须严格匹配：
- 查当前 PHP 类型：
php -i | findstr "Thread Safety"，输出enabled为 TS，disabled为 NTS - 查架构：
php -i | findstr "Architecture"，确认是 x64 还是 x86 - 对应 DLL 名（PHP 8.3）：
php_gd.dll（NTS x64）、php_gd_ts.dll（TS x64）；不存在php_gd2.dll了 - 路径错误高发点：
extension_dir必须指向ext目录，且该目录下要有对应 DLL；不要把 DLL 放到system32——现代 PHP 不读那里 - 依赖 DLL（如
libpng16.dll）必须和 PHP 主程序在同一目录（即php.exe所在文件夹），否则imagecreatefrompng()直接返回false
最易被忽略的一点：GD 在 PHP 8.3+ 中默认禁用部分老旧函数（如 ImageCreateFromGd2Part()），且对 JPEG 的 CMYK 支持仍不稳定；做生产级图像处理前，务必用真实图片跑一遍 imagecreatefromjpeg() → imagejpeg() 流程，别只信 gd_info() 里的 jpeg support => 1。
