Composer install报错缺扩展是因PHP CLI环境未加载对应模块，需用php -m | grep验证缺失扩展、php --ini定位CLI配置文件，Linux用apt/dnf安装带版本号的扩展包（如php8.2-zip），Windows和宝塔需确认php.ini路径及extension_dir正确并重启服务。
Composer install 报错缺扩展，不是 Composer 的锅，而是当前 PHP CLI 环境没加载对应模块——直接查、直接启、别绕弯。
怎么确认到底缺哪个扩展
报错里写的 ext-zip、ext-gd、ext-dom 就是你要找的扩展名；别猜，复制报错里的名字就行。关键要验证 CLI 模式下是否真没加载：
- 运行
php -m | grep zip（把zip换成你报错里的扩展名）——无输出就确认缺失 - 运行
php --ini查看 CLI 实际读的是哪个php.ini，别在 Web 配置里改完就以为好了 - 如果
php -m有输出但 Composer 还报错，大概率是用了多个 PHP 版本，比如which php和宝塔里设的版本不一致
Linux 下用包管理器装扩展最稳
Ubuntu/Debian 直接装对应包，自动启用，不用碰 php.ini：
-
sudo apt install php-zip（PHP 8.0+ 默认可用） -
sudo apt install php8.2-gd（带版本号更保险，尤其多 PHP 共存时） -
sudo apt install php8.2-dom、sudo apt install php8.2-xml、sudo apt install php8.2-intl
CentOS/RHEL 7 用：sudo yum install php-pecl-zip；8+ 用：sudo dnf install php-zip。装完新开终端再试，别信“已安装”就完事。
立即学习“PHP免费学习笔记（深入）”；
Windows 和宝塔里手动启扩展要注意什么
Windows 下常见问题是改了 php.ini 却没生效：
- 必须用
php --ini找到 CLI 真正读的文件，不是 WAMP/XAMPP 控制面板里显示的那个 - 搜索
extension=php_fileinfo.dll或extension=fileinfo，去掉前面分号；PHP 8.0+ 可省略.dll - 确保
extension_dir指向正确，比如extension_dir = "ext"，且该目录下真有php_fileinfo.dll
宝塔用户记住两件事：
- 进「软件商店」→ 找对应 PHP 版本 → 「设置」→ 「安装扩展」→ 开
fileinfo、zip、gd等，点完必须点右上角「重载配置」 - 如果「安装扩展」里压根没选项，说明 PHP 是精简编译版，得手动编辑
php.ini加extension=fileinfo.so，再确认fileinfo.so文件存在（路径类似/www/server/php/80/lib/php/extensions/no-debug-non-zts-*/fileinfo.so）
为什么开了还报错？三个高频漏点
最常卡住的地方不在“怎么开”，而在“谁在用”：
- CLI 和 Web 用不同 PHP：
php -v和宝塔面板里网站设置的 PHP 版本不一致，Composer 只认php -v那个 - 装了但没重启终端：Linux/macOS 装完扩展后，旧终端里的 PHP 进程还缓着旧配置，关掉重开
-
composer diagnose比composer install更早暴露问题，先跑它，别等装一半失败才回头查
真正麻烦的从来不是扩展名记不住，而是改了 A 的配置却让 B 在跑。
