换源是必须第一步，否则优化无效；需严格配置repo.packagist为小写单数、含type和末尾斜杠的https url，删composer.lock和vendor后重装，并优先用项目级配置。
换源不是“试试看”，而是必须做的第一步；不换源，其他所有优化基本无效。国内直连 packagist.org 的典型表现是卡在 Downloading 或 Loading repositories，本质是 DNS 解析慢、TLS 握手卡顿、首字节延迟常超 300ms+，和你本地网络质量关系不大。
composer config -g repo.packagist 命令为什么总不生效
它不会报错，但执行后 composer install 依然卡在 Downloading https://codeload.github.com/——八成是命令写错了。Composer 2.x 对配置极其严格，漏掉任一硬性条件就静默回退到官方源：
-
repo.packagist必须是单数、全小写；写成repos.packagist（多一个 s）、packagist（少repo.）或Repo.Packagist都无效 - 中间的
composer是必需的type值，不是可选参数；漏掉它，Composer 就当没配 - URL 必须以
https://开头，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json，返回 404） - 验证是否真写进去了：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象（如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是那个带斜杠的 URL 字符串；空、null、或仍是https://packagist.org，说明根本没写成功
换源后仍卡在 Downloading？清缓存和锁文件才是关键
镜像只加速元数据拉取和 ZIP 包下载，但 composer.lock 里存的是旧 dist URL，vendor/ 里也缓着原始地址的包——不清理它们，换源等于白配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须删掉
composer.lock和vendor/目录，再跑composer install；否则旧dist.url会照用不误 -
--repository参数只影响元数据拉取环节，对已存在的composer.lock完全无效 - 执行
composer clear-cache很关键，尤其当你之前试过多个镜像或改过配置但没生效时 - 如果项目用了私有仓库或 Satis 源，删
composer.lock后务必确认composer.json的repositories仍完整，否则某些包会直接不可见
项目级配置比全局更可靠，尤其在 CI/CD 场景
全局配置写在 ~/.composer/config.json，但它只对当前用户生效。宝塔默认用 www 用户执行，GitHub Actions 用 runner，Docker 容器里可能是 www-data——配了 root 的全局配置，www 根本读不到：
- 推荐进入项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会自动向
composer.json的repositories字段追加条目，不破坏已有私有源；如果是空对象"repositories": {}，它会转为数组并插入 - 千万别手动写
"packagist": false——这会导致php、ext-json等基础扩展校验失败 - 改完后立刻运行：
composer update --lock，确保composer.lock记录的是镜像源地址，而非官方源
最常被忽略的点是：镜像只解决下载环节，不解决 Resolving dependencies 卡顿。那阶段慢，要查 COMPOSER_MEMORY_LIMIT 是否够、Xdebug 是否开着、config.platform.php 是否与实际 PHP 版本匹配——这些和源无关，但容易误判为“换源没用”。
