Composer中文镜像与Composer核心代码仓库访问优化-composer-PHP中文网

答案是repo.packagist拼写错误（如写成repos.packagist）导致静默失效，必须严格满足三条件：键名唯一为repo.packagist（单数）、type值为composer、url以/结尾；项目级repositories会完全屏蔽全局配置。

composer中文镜像与composer核心代码仓库访问优化

repo.packagist配置写错就等于没配

绝大多数“换源后还是慢”的问题，根源是repo.packagist拼写错误。它不是repos.packagist（多一个s），也不是packagist.org——写错就静默失效，不报错、不警告，composer config -g repo.packagist输出为空或null。

必须同时满足三点才真正生效：

repo.packagist 是唯一合法键名（注意：没有s，不是复数）
中间的composer是type字段值，不能省略
URL 必须以/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会触发路径拼接错误，返回 404）

验证命令：composer config -g repo.packagist，输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、报错、或只返回字符串而非 JSON，说明根本没写进去。

项目级 repositories 会直接屏蔽全局镜像

Composer 源优先级严格为：项目级 > 全局 > 默认源。只要当前目录composer.json里有repositories字段，哪怕内容是空对象"repositories": {}，全局配置也会被彻底忽略。

常见踩坑点：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

"repositories": []（数组格式）会导致composer config repo.packagist命令失败，必须手动改为对象格式
手写"packagist.org": false但没显式定义新的packagist key，结果所有基础包（如monolog/monolog）都拉不到

安全写法是显式声明"packagist"这个固定 key：

{
  "repositories": {
    "packagist": {
      "type": "composer",
      "url": "https://mirrors.aliyun.com/composer/"
    }
  }
}

parallel-downloads 在 Composer 2.2+ 才真正起作用

parallel-downloads默认值是3，相当于没开并发。设了但没提速？先确认版本：composer --version。低于2.2.x必须升级：composer self-update --prefer-dist。

设完还要注意两点：

该参数只对composer install生效；composer update仍需串行解析依赖图，无法靠并发加速
并发过高（如设10）易触发临时文件竞争，典型报错：file_put_contents(/tmp/): failed to open stream，此时应立即降到6或8
并发效果严重依赖镜像源是否支持 HTTP/2；如果镜像本身没生效，parallel-downloads连启动机会都没有

--prefer-dist 被项目级 prefer-source 覆盖时完全无效

--prefer-dist本意是跳过 Git clone、直下 ZIP 包，但会被项目级composer.json里的"prefer-source": true强制覆盖。这种配置常因协作误提交而存在，导致你加了参数也白加。

排查和修复方法：

进项目根目录，搜索：grep -n "prefer-source" composer.json
若存在，执行：composer config --unset prefer-source（推荐）或手动删掉该字段
注意：私有包若只提供 Git 地址、未发布 dist 包，--prefer-dist会直接报错Could not find a matching version of package xxx，此时只能关掉该参数
国内镜像（如阿里云）只缓存 dist 包，不缓存 source；镜像失效时，--prefer-dist会降级为慢速 Git clone，反而更卡

镜像只管下载，不管依赖解析；Resolving dependencies卡住，和镜像无关，得看约束写法、稳定性设置和composer.lock是否完整。配置再准，漏掉--no-dev或--optimize-autoloader，部署时照样慢半拍。