composer config -g repo.packagist 不生效的根本原因是未同时满足三个硬性条件：键名必须为单数 repo.packagist、type 值必须显式写 composer、url 必须 https 且末尾带 /；任一缺失即静默回退官方源。
Composer 加速不是配完镜像就完事了，真正卡住的环节往往在缓存污染、配置未生效、用户权限错位这三处——90% 的“慢”问题其实跟网络无关。
composer config -g repo.packagist 为什么总不生效
这条命令极易静默失败，必须同时满足三个硬条件：
-
repo.packagist不能写成repos.packagist（多一个 s 就被完全忽略） - 中间必须带
composer这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉composer就 fallback 到默认源 ❌ - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会 404）
验证是否真正生效：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null 或仍是 https://packagist.org 都说明没写进去。
装完不立刻清缓存，镜像等于白配
缓存污染是加速失效最隐蔽的原因——旧缓存里存着从 packagist.org 下载的 packages.json 和元数据，哪怕你刚配好阿里云镜像，composer install 仍会去读旧缓存，结果还是慢。
装完镜像后必须立刻执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/-
composer config -g parallel-downloads 10（Composer 2.2+；旧版用concurrent.http.max-parallel-downloads） composer config -g prefer-dist true-
composer clear-cache（这一步不可省）
验证方式：分别运行 composer config -g repo.packagist、composer config -g parallel-downloads、composer config -g prefer-dist，三个都应输出对应值。
项目级 repositories 字段会直接覆盖全局镜像
换源后还是慢？大概率是项目自己“不听话”：
- 检查项目根目录
composer.json是否有repositories字段——它会直接覆盖全局repo.packagist配置 - 运行
composer config --list和composer config --list --global对比，确认实际生效的是哪个配置 - 宝塔、CI 或计划任务常以
www用户运行，但composer config -g写的是root配置（路径为/root/.composer/config.json），www根本读不到；应切到对应用户下执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
生产环境 install 命令必须加这三参数
composer install 在生产环境不加参数，等于主动放弃 70% 以上优化空间：
-
--no-dev：跳过require-dev所有依赖，减少 50%+ 文件下载量 -
--optimize-autoloader（或-o）：生成vendor/composer/autoload_classmap.php，类加载速度提升 200–300% -
--prefer-dist：强制使用压缩包而非 Git 克隆，避免反复拉取源码
组合起来就是：composer install --no-dev --optimize-autoloader --prefer-dist。再叠加 composer clear-cache，实测可将耗时从 45 秒压到 10 秒以内（基于 Composer 2.7 + PHP 8.2 环境）。
最容易被忽略的点：项目级 repositories 配置和用户权限错位，这两处不会报错，但会让所有加速配置彻底失效——得先查 composer config --list 输出，再看实际运行时用的是哪个用户、哪个配置文件。
