composer报“缺少扩展包”本质是php cli环境缺扩展或镜像源未同步，需用php -m验证扩展、composer show和curl检查镜像状态，二者问题独立且修复路径不同。
Composer 报“缺少扩展包”，通常不是 Composer 本身的问题，而是你本地 PHP CLI 环境缺扩展 或 镜像源没同步到最新元数据——两者常被混为一谈，但修复路径完全不同。
php -m | grep xxx 没输出，说明 PHP CLI 真没加载扩展
Composer 只看 php -m 的输出，不读 Web 环境的 phpinfo()。常见错误包括：
- 只在 Apache 的
php.ini里启用了mbstring，但php --ini显示 CLI 加载的是另一份配置（比如/etc/php/8.2/cli/php.ini） - Ubuntu/Debian 上装了
php-zip，但实际 CLI 用的是 PHP 8.2，必须装php8.2-zip，否则apt不报错也不生效 - Windows 下
php.ini里写了extension=php_mbstring.dll，但extension_dir指向的目录里实际是php_mbstring7.dll（版本号不匹配） - 某些扩展如
intl依赖系统库（libicu），只装php-intl不够，还得sudo apt install libicu-dev
composer show xxx/yyy 找不到，但 packagist.org 上有
这是镜像源问题，不是你环境的问题。验证步骤要闭环：
- 运行
composer config -g repos.packagist.org，确认输出是镜像 URL（如https://mirrors.aliyun.com/composer/），不是空或官方地址 - 手动
curl -I https://mirrors.aliyun.com/composer/packages.json，HTTP 状态码不是 200 就说明镜像服务异常或未同步 - 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org，再跑composer show xxx/yyy—— 能查到就坐实是镜像延迟 - 注意：部分镜像会过滤
abandoned包或minimum-stability: dev的包，即使官方有，镜像也可能跳过索引
想绕过镜像缺失又不想等同步，三种方式按优先级试
别直接改 composer.json 全局加仓库，容易引发冲突：
- 临时指定源安装：
composer require xxx/yyy --repository=https://packagist.org，单次生效，不影响全局配置 - 在
composer.json里加自定义仓库时，必须同时设"packagist": false，否则 Composer 仍可能优先走镜像源 - 强制走源码安装：
composer config --global preferred-install source，再composer require xxx/yyy—— 这样它会直接git clone，只要 GitHub 可达就行，完全绕过镜像的/p/xxx/yyy.json接口
最常被忽略的一点：镜像同步延迟和 PHP 扩展缺失是两类独立问题，但报错现象相似（都表现为“找不到”）。先用 php -m 和 composer show 分清是本地环境断链，还是远端元数据断链，再动手，不然容易白忙活半天。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
