使用Composer中文镜像解决国内开发环境下载慢的现状-composer-PHP中文网

composer全局换源不生效的根本原因是命令书写错误：必须带-g参数、键名严格为repo.packagist（非repos或packagist.org）、url末尾必须有/，三者缺一都会静默失败。

使用composer中文镜像解决国内开发环境下载慢的现状

composer config -g repo.packagist 命令为什么总不生效

根本原因不是网络问题，而是命令写错三个硬性条件，Composer 会静默失败，不报错也不提示。执行后 composer config -g repo.packagist 输出为空、null 或仍是 https://packagist.org，就说明没写进去。

-g 参数不能省：缺了就只改当前项目 composer.json，换目录即失效
键名必须是 repo.packagist（单数、小写、无 s），写成 repos.packagist 或 packagist.org 都无效
中间的 composer 是 type 值，不是可选描述词——省略后 Composer 2.0+ 会 fallback 到官方源
URL 必须以 / 结尾，比如 https://mirrors.aliyun.com/composer/，漏掉斜杠会导致拼出 /composerpackages.json，返回 404 且无日志提示

换源后仍卡在 “Loading composer repositories” 怎么办

镜像只替换元数据接口和 ZIP 分发节点，两者必须严格匹配。如果卡在这里，大概率是缓存里还存着旧的 packages.json 和 provider 数据，Composer 优先读本地缓存再校验远程地址——哪怕你已切镜像，它仍反复尝试从 https://packagist.org 拉索引，卡在 DNS 或 TLS 握手阶段。

Discussion Composer

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

下载

必须执行 composer clear-cache（不是 composer cache-clear，后者已废弃）
验证是否清干净：检查 ~/.composer/cache/（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\Cache\（Windows）目录是否为空
临时绕过缓存验证：加 --no-cache 参数跑一次 composer install -vvv，看日志里实际请求的是哪个域名
注意：某些 CI 环境（如 GitHub Actions）默认不读全局缓存，需显式设置 COMPOSER_CACHE_DIR

项目级配置比全局更可靠的实际场景

全局配置看着省事，但在宝塔、CI 或多用户环境下极易失效：宝塔默认以 www 用户运行，GitHub Actions 用 runner 用户，它们根本读不到你本地 root 或 admin 的配置。

进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
该命令会自动向 composer.json 的 repositories 字段追加，不覆盖已有私有源，前提是原 repositories 是对象结构（不是数组）
如果项目已有 "repositories": [] 数组形式，别手动覆盖，用命令追加，否则可能误删私有包源
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则仍可能复用旧锁文件里的官方源记录

parallel-downloads 设太高反而失败的原因

这个参数只对 composer install 有效，它控制并发下载 ZIP 包的数量，默认值 3 几乎等于没开。但它依赖镜像站支持 HTTP/2 多路复用，不是设得越高越快。

推荐设为 10：composer config -g parallel-downloads 10
别盲目冲到 20：低配 CI 环境或企业内网可能出现 file_put_contents(): failed to open stream（临时文件竞争）
阿里云、清华、中科大镜像都支持 HTTP/2；私有源不支持的话，设高了也白搭
运行 composer --version 确认是 2.2+，1.x 版本需先 composer self-update

真正卡住的地方往往不是“要不要换源”，而是换源后缓存没清、配置键名写错、或者项目里已有 "packagist.org": false 这类禁用默认源的配置——它会直接屏蔽全局镜像，连验证命令都查不出来。