插件不生效主因是镜像配置错误或插件api版本不兼容：repo.packagist键名错、type值缺失、url末尾缺/会导致fallback至官方源；插件需声明"composer-plugin-api": "^2.2.0"且全局配置验证输出必须为完整json。
composer config -g repo.packagist 配置后插件仍不生效？先查这三处
不是插件坏了，而是镜像配置和插件加载机制在底层打架。Composer 2.2+ 的并行下载逻辑与旧插件（如 composer-parallel-install）存在硬冲突，但更隐蔽的问题是：插件本身可能根本没被加载——因为全局镜像配置写错，导致 Composer fallback 到官方源，而某些插件只监听镜像源事件。
必须逐项验证：
-
repo.packagist字段名不能多一个s（repos.packagist是无效键，静默忽略） -
type值必须显式传composer，漏掉则视为配置缺失，直接退回到packagist.org - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼接/p2/时变成/p2//，404 后静默降级）
验证命令：composer config -g repo.packagist 输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
插件兼容性不是“能装就行”，要看 composer-plugin-api 版本声明
Composer 2.x 插件失效的典型表现是：没报错、没日志、钩子函数（如 post-install-cmd）完全不触发。根源在于插件 composer.json 中未声明对新版插件 API 的支持。
打开插件目录下的 composer.json，重点检查：
-
"require": {"composer-plugin-api": "^2.0"}—— 最低要求，但实际建议"^2.2.0"（2.2+ 才有并行下载接口） "conflict": {"composer-plugin-api": " —— 显式拒绝旧版，避免静默跳过- 若只有
"composer-plugin-api": "^1.0"，哪怕composer install成功，dump-autoload等关键动作也可能被跳过
最可靠验证方式：rm -rf vendor composer.lock && composer install -v | grep "Plugin.*loading"。没这一行输出，基本可判定插件未加载。
换镜像后插件行为异常？优先停用所有第三方并行类插件
composer-parallel-install、hirak/prestissimo 这类插件在 Composer 2.2+ 环境中已成累赘：它们会覆盖 install 命令、干扰 HTTP/2 多路复用、触发临时文件写入失败（如 file_put_contents(/tmp/): failed to open stream），且与阿里云/腾讯云镜像的并发连接限流策略不兼容。
正确做法是彻底移除：
- 卸载：
composer global remove hirak/prestissimo composer-parallel-install - 确认无残留：
composer global list | grep -E "(prestissimo|parallel)"应为空 - 改用原生并发参数：
composer config -g parallel-downloads 10（国内镜像安全上限，超 12 易触发Connection refused）
注意：parallel-downloads 只加速 .tar 包下载阶段，前提是镜像已启用 --prefer-dist 且缓存了 dist 包；若项目里写了 "prefer-source": true，该参数完全无效。
验证镜像 + 插件是否真协同工作？别信 config 输出，看网络请求日志
composer config -g repo.packagist 只告诉你“配了什么”，不告诉你“用了什么”。项目级 repositories 字段会完全覆盖全局配置，而插件往往依赖特定源的响应结构（比如某些资产插件只认 packagist.org 格式元数据）。
真实验证步骤：
- 删掉
vendor/和composer.lock - 执行：
composer install -vvv 2>&1 | grep "GET " - 成功标志：日志中出现
GET https://mirrors.aliyun.com/composer/p2/topthink/think.json（带p2/路径），而非packagist.org或api.github.com - 若看到
GET https://packagist.org/packages.json，说明镜像未生效，插件再兼容也白搭
复杂点在于：插件可能在元数据解析后才介入（如修改包安装路径），但若第一步就走错源，后续所有逻辑都跑偏。测速脚本、并发参数、插件钩子，全得建立在“请求真发到了镜像站”这个前提上。
