换镜像源不能解决所有慢问题，但卡在Downloading或Loading repositories时90%因配置未生效：键名必须为repo.packagist（非repos）、第二参数必写composer、URL须以https://开头且结尾带/，配后需用composer config -g repo.packagist和composer install -vvv双验证。
换镜像源本身不能解决所有 Composer 安装慢问题，但 composer install 卡在 Downloading 或 Loading composer repositories 时，90% 是因为没切对源、缓存没清、或配置被静默忽略——不是网络差，是配置没生效。
为什么 composer config -g repo.packagist 配了却没用
这条命令极易写错，且错误时不报任何提示，直接静默失败：
- 键名必须是
repo.packagist（不是repos.packagist、mirror或packagist.org） - 第二个参数必须显式写
composer（这是仓库类型声明，漏掉就会 fallback 到官方源） - URL 必须以
https://开头、且末尾带/（https://mirrors.aliyun.com/composer/✅，少斜杠会拼出 404） - 执行后必须验证：
composer config -g repo.packagist输出应为完整 URL 或{"type": "composer", "url": "https://..."}；空、null、或仍显示https://packagist.org都说明没写进去
composer install 还在请求 github.com 怎么办
元数据走镜像 ≠ ZIP 包也走镜像。阿里云、清华等主流镜像只代理 packages.json 和元数据，不托管 dist ZIP 文件——所以 composer install -vvv 里仍会出现 Downloading https://codeload.github.com/。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 真正起效的方案是：用
ghproxy.com类反向代理，或企业级部署satis/toran proxy - 临时绕过：进项目根目录，在
composer.json的repositories中为高频包手动指定dist地址（如"url": "https://ghproxy.com/https://github.com/vlucas/phpdotenv/archive/refs/tags/v3.0.0.zip"） - 关键限制：
--repository参数对已存在的composer.lock无效——只要 lock 文件里记着github.com的 dist URL，Composer 就照单下载，无视任何新配置
哪些操作必须配合镜像一起做
只换源不清理，等于白干：
-
composer clear-cache（不是cache-clear，后者已废弃），否则缓存里旧的packages.json会持续触发对packagist.org的校验请求 - 删掉项目里的
composer.lock和vendor/，再跑composer install——否则 lock 文件锁定的旧 dist URL 不会更新 - 加
--no-cache临时验证：composer install -vvv --no-cache 2>&1 | grep "Loading composer repositories"，确认日志中出现的是你配的镜像域名（如mirrors.aliyun.com） - CI/宝塔/多用户环境别信全局配置：
composer config -g写的是当前用户的~/.composer/config.json，而宝塔默认用www用户、GitHub Actions 用runner用户，它们根本读不到你的 root 配置
为什么项目级配置比全局更可靠
全局配置依赖执行用户和环境一致性，而项目级配置直接写进 composer.json，随代码提交、构建即生效：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会自动在
composer.json的repositories数组首位追加镜像条目，不破坏已有私有源结构 - 注意：
"packagist": true必须保留（别手误改成false），否则基础包无法解析 - 团队协作或 CI 场景下，这是唯一能确保所有人、所有机器行为一致的方式
最常被跳过的一步是删 composer.lock：它像一张快照，锁死了所有 dist URL 和版本号，不删它，再新的镜像配置也只是摆设。
