配错composer config -g repo.packagist就等于未配置镜像，90%失效源于键名错误（如repos.packagist）、漏写composer类型参数或url末尾缺斜杠；验证需输出完整json，空/null或仍为packagist.org说明未生效。
composer config -g repo.packagist 配错就等于没配
镜像不生效，90% 是因为 repo.packagist 这个键写错了。常见错误包括：repos.packagist（多一个 s）、漏掉中间的 composer 类型参数、URL 缺末尾斜杠。比如：https://mirrors.aliyun.com/composer ❌ 会拼出 /composerpackages.json 导致 404；必须是 https://mirrors.aliyun.com/composer/ ✅。
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明配置根本没落盘。
镜像只加速下载，不解决 Resolving dependencies 卡顿
Resolving dependencies 阶段卡住，和镜像完全无关——这一步纯本地计算，不发任何网络请求。真实瓶颈通常来自：
-
composer.json里写了过宽的版本约束，比如"php": "*"或"^7.4 || ^8.0 || ^8.1 || ^8.2"，让求解器暴力穷举 - 启用了
xdebug（用php -v确认），会让解析慢 5–10 倍 -
config.platform.php和当前 PHP 版本不匹配，触发降级回溯逻辑 -
composer.lock引用了已下线包，Composer 会 fallback 到packagist.org/packages.json（20MB+）重试
临时排查可加 COMPOSER_MEMORY_LIMIT=-1 或用 php -d xdebug.mode=off $(which composer) install。
--prefer-dist 被项目级配置悄悄覆盖
--prefer-dist 是提速关键，但会被项目 composer.json 中的 "prefer-source": true 强行关掉。这种字段常因协作误提交而存在。
检查方式：在项目根目录执行 grep -n "prefer-source" composer.json。修复方法有两个：
- 手动删掉该字段
- 运行
composer config --unset prefer-source
注意：--prefer-dist 依赖镜像站缓存 dist 包。如果私有包只提供 Git 地址、没发布 ZIP，它会直接报 Could not find a matching version of package xxx，此时只能关掉该参数。
并发下载设置容易白配
parallel-downloads 已被弃用，新版 Composer（2.2+）只认 http-max-concurrent-downloads。设了前者完全无效，也不报错。
正确命令是：composer config -g http-max-concurrent-downloads 10。值别超过 12，否则可能触发 file_put_contents(/tmp/): failed to open stream 错误。
这个配置还依赖镜像源支持 HTTP/2；如果镜像本身没生效，它连并发机会都没有，退化为串行。
最常被忽略的是路径仓库（"type": "path"）带来的 I/O 拖累：几十个子包反复 Reading composer.json 不是网络问题，而是文件读取+JSON 解析耗 CPU。禁用方式是 composer config -g repositories.path.type disabled，而不是换镜像。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
