命令不生效主因是书写错误且静默回退：漏 -g、误写 repos.packagist、缺 composer type 参数，正确命令为 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不可少）。
composer config -g repo.packagist 命令为什么总不生效
90% 的失败不是网络问题，是命令写错且静默忽略——漏掉 -g、把 repo.packagist 写成 repos.packagist（多一个 s）、中间漏掉 composer 这个 type 参数，三者任一出错，Composer 就自动 fallback 到 packagist.org，不报错也不提示。
必须一次性写对：
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少） - 验证方式：运行
composer config -g repo.packagist，输出应为完整 JSON 对象，含"type": "composer"和正确 URL；若为空、null或仍是https://packagist.org，说明没写进去 - 宝塔、Docker 或 CI 中常以
www用户运行，但root下配的全局配置它读不到，得切用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换镜像后 still stuck at “Resolving dependencies”
镜像只加速下载，完全不参与依赖解析。这个阶段卡住，100% 是本地环境或 composer.json 写法问题。
常见原因：
- PHP 版本约束太宽，比如
"php": "*"或"^7.4 || ^8.0"，触发组合爆炸式求解 -
composer.json里写了"ext-swoole": "*"—— 这只是声明“我需要扩展已启用”，不是安装指令，也不会影响解析，但容易误导人以为它在查扩展兼容性 - 启用了
xdebug，大幅拖慢 Composer 自身执行速度；临时禁用：php -d xdebug.mode=off composer update -
composer.lock过旧或缺失，导致每次都要重算全部依赖；先试composer update --lock轻量更新 - 项目中存在已下线的私有仓库，Composer 会逐个超时重试，耗时可达分钟级
如何让 --prefer-dist 真正生效
--prefer-dist 不是开关，而是策略：它告诉 Composer 优先下载 ZIP 包，但前提是镜像源真有这个包，且缓存干净。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操要点：
- 必须和镜像同步启用——国内镜像（阿里云/腾讯云/清华）几乎只缓存
dist包，不缓存source；镜像没切成功，--prefer-dist就会 fallback 到慢速 Git clone - 执行前务必清缓存：
composer clear-cache，否则旧元数据还在，Composer 仍试图从海外地址拉校验信息 - 检查项目级配置是否覆盖了全局：
composer.json里若有"config": {"prefer-source": true}，会直接关掉--prefer-dist，必须删掉 - CI 脚本中建议显式带上：
composer install --prefer-dist --no-dev --no-autoloader --no-scripts
parallel-downloads=10 是不是开得越大越好
不是。并发下载只对 composer install 有效，且依赖镜像服务端支持 HTTP/2 多路复用。设太高反而触发排队或 CDN 限流。
推荐做法：
- Composer 2.2+ 默认
parallel-downloads=3，基本等于串行；设为10是实测平衡点：composer config -g parallel-downloads 10 - 别装过时插件如
hirak/prestissimo，它在 Composer 2.2+ 中已被原生机制替代，还可能干扰并发逻辑 - 如果发现并发后反而更慢，大概率是镜像节点带宽饱和或本地 DNS 解析不稳定，可临时降回
5或换镜像源（比如从阿里云切到清华） - 注意：该参数对
composer update无效，它只加速已确定版本的包下载，不加速依赖解析
最易被忽略的一点：镜像同步有延迟，新发布的包可能 15 分钟内还没出现在镜像里。别急着关 fallback，Composer 2.2+ 默认开启官方源兜底，只要镜像返回 404 或 503，就会自动切回 packagist.org 查一次——这个保险丝，别手动拧掉。
