换镜像源是提升 Composer 下载速度的必要第一步，必须通过 -vvv 日志确认请求域名是否为所设镜像，且命令需严格为 composer config [-g] repo.packagist composer https://mirrors.aliyun.com/composer/（末尾带斜杠），项目级配置优于全局配置。
换镜像源是提升 Composer 下载速度最直接有效的手段，不是“可选优化”，而是必须做的第一步。其他操作（如调大并发、禁用 Xdebug）只有在镜像生效后才真正有意义。
确认当前是否真走国内镜像
很多人以为执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就万事大吉，其实它极易静默失效。
-
composer config -g repo.packagist必须输出完整 JSON 对象，例如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果返回空、null、报错或仍是https://packagist.org，说明没写进去 - 项目级
composer.json中若有"repositories"字段，会直接覆盖全局配置——这是最常被忽略的失效原因 - 唯一能 100% 确认的方式是加
-vvv：运行composer install -vvv 2>&1 | grep "Downloading"，看 URL 域名是不是mirrors.aliyun.com或其它你设的镜像域名
写对命令才能真正生效
Composer 2.x（当前主流版本）对配置命令极其严格，错一个字符就回退官方源，且不提示。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（单数，不能多s写成repos.packagist） - 中间的
composer是type值，不可省略，也不能换成https或其他字符串 - URL 必须以
https://开头，且末尾必须带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致 404） - 一定要加
-g，否则只改当前目录下的composer.json，换个项目就失效
项目级配置比全局更可控
团队协作或 CI 环境中，全局镜像反而容易引发不一致问题（比如依赖 hash 校验失败），推荐用项目级方式。
- 进项目根目录，执行不带
-g的命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 它会自动在
composer.json顶层添加或更新"repositories"字段，key 固定为"packagist"，不会破坏已有私有源 - 如果项目已有
"repositories": []数组，命令会向末尾追加新项；如果是{}对象，会转为标准格式并插入 - 千万别手动写
"packagist": false，这会导致基础扩展（如ext-json）校验失败
换镜像后还慢？别怪源，先查这三件事
镜像只加速下载阶段，卡在 Resolving dependencies 和镜像无关，那是本地环境问题。
- PHP 内存不足：默认
128M不够解析复杂依赖图，临时试COMPOSER_MEMORY_LIMIT=-1 composer install - Xdebug 启用：运行
php -v查是否带xdebug，它会让解析慢 5–10 倍，可用php -d xdebug.mode=off $(which composer) install临时禁用 -
platform配置与实际 PHP 版本不匹配：比如"php": "7.4"却在 PHP 8.2 上运行，触发降级查找逻辑，删掉composer.lock和vendor/后重装更干净
真正关键的是：别只看命令有没有报错，要看 -vvv 日志里到底请求了哪个域名。很多问题不是镜像不行，而是压根没走过去。
