GD库需在phpenv管理的PHP版本编译时通过依赖库和--with-gd参数启用，而非靠系统包安装；Ubuntu需先装libpng-dev等依赖再phpenv install，macOS需指定路径避免configure跳过GD，且须验证WebP等关键格式支持。
phpenv 本身不提供 GD 库，它只是 PHP 版本管理工具；开启 GD 是在所选 PHP 版本里启用扩展，不是 phpenv 自身的配置项。
检查当前 PHP 是否已带 GD 支持
运行以下命令看输出是否含 GD Support => enabled：
php -i | grep "GD Support"
如果没输出或显示 disabled，说明当前 phpenv 切换的 PHP 版本未编译 GD，或虽编译但未加载扩展。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
-
gd_info()报错Call to undefined function gd_info() - 图片生成函数如
imagecreatetruecolor()直接 fatal error
Ubuntu/Debian 下用 phpenv + apt 安装 GD 的实际路径
phpenv 管理的是源码编译的 PHP，而系统包（如 php-gd）安装的是预编译二进制，二者不互通。所以不能靠 sudo apt install php-gd 让 phpenv 的 PHP 生效。
你必须：
- 确保编译 PHP 前已装好依赖：
libpng-dev、libjpeg-dev、libfreetype6-dev - 编译时加
--with-gd参数（PHP 7.4+ 可省略，只要依赖存在，configure 会自动启用） - 若已编译过，需重新
phpenv install该版本（或手动编译后phpenv rehash）
示例编译前检查依赖：
sudo apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev
再执行：
phpenv install 8.1.27
它会自动检测系统库并启用 GD —— 但前提是这些 dev 包已就位。
Windows 或 macOS 上用 phpenv 开启 GD 的注意事项
phpenv 在 Windows 上基本不可用（官方不支持），macOS 上依赖 autoconf、openssl 等工具链，GD 编译失败常因：
-
libpng路径未被 configure 找到（Homebrew 安装的通常在/opt/homebrew或/usr/local） -
freetype版本太新（如 2.13+），某些 PHP 版本会报FT_Property_Get未定义
解决方法是显式指定路径：
CONFIGURE_OPTS="--with-gd --with-png-dir=/opt/homebrew --with-jpeg-dir=/opt/homebrew --with-freetype-dir=/opt/homebrew" phpenv install 8.2.12
否则 configure 阶段可能静默跳过 GD，导致后续 gd_info() 返回全 false。
验证 GD 功能是否完整可用
仅 gd_info()["GD Support"] === true 不够，还要确认关键格式支持：
<?php $info = gd_info(); var_dump([ 'jpeg' => $info['JPEG Support'], 'png' => $info['PNG Support'], 'webp' => $info['WebP Support'], 'freetype' => $info['FreeType Support'] ]); ?>
容易被忽略的一点：WebP Support 在 PHP 8.0+ 默认开启，但若系统没装 libwebp-dev，configure 会禁用它，且不报错——结果就是 imagewebp() 函数不存在，而你只看到 GD Support => true 就以为万事大吉。
