不配中文镜像，composer install 基本跑不起来；config -g repo.packagist 失效主因是键名错（如repos.packagist）、漏type值“composer”、URL末尾缺/，三者任一出错即静默回退官方源。
不配中文镜像，composer install 基本跑不起来——不是慢，是频繁 403、超时、卡在 Downloading 或 Loading composer repositories。镜像不是“锦上添花”，而是国内 PHP 开发的启动前提。
为什么 composer config -g repo.packagist 总不生效
90% 的失败配置不报错，但完全无效。关键就卡在这三处：
-
repo.packagist不能写成repos.packagist（多一个s就失效） - 中间那个
composer是type参数，必须显式写出：正确命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉它等于白配 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致路径拼成/p2//类错误）
验证是否写入成功：运行 composer config -g repo.packagist，输出应为完整 JSON（旧版）或纯 URL 字符串（新版）。若为空、null 或仍是 https://packagist.org，说明没写进去。
项目级 repositories 覆盖全局镜像怎么办
Composer 源优先级固定为：项目级 > 全局 > 默认源。只要项目 composer.json 里有 repositories 字段，全局配置就静默失效——哪怕它只是空对象 "repositories": {}。
- 安全写法是显式声明
packagistkey：{"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/"}}} - 别用数组格式
"repositories": []，会触发composer config repo.packagist报错 - 如果项目已有私有源，不要删掉原有
repositories，而是合并；否则私有包将不可见
composer install 还卡在 Resolving dependencies？镜像真不管这事
镜像只加速下载，不参与依赖解析。这个阶段卡住，和网络无关，典型原因有：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json中约束太宽，比如"php": "^7.4 || ^8.0 || ^8.1"，求解器暴力遍历组合 - 设了
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸增长 -
composer.lock被删或未提交，install实际退化为update，重新解析全图 - 项目
repositories指向已下线私有源，Composer 逐个超时才 fallback
快速排查：进项目根目录执行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 确认 lock 文件合法。
真正提速要加这四个参数
光换镜像只是第一步。生产环境或 CI/CD 中必加：
-
--no-dev：跳过require-dev（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉自动加载器“没在映射里 = 真没有”，彻底跳过文件扫描
CI/CD 推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类会直接 Class not found。
最常被忽略的是并发下载——Composer 2.2+ 默认仅开 3 个并发线程，相当于把高速路压成单车道。必须手动启用：composer config -g parallel-downloads 8。设为 10 容易触发临时文件竞争，报 file_put_contents(/tmp/): failed to open stream。
