必须配置国内镜像源，否则composer install大概率卡在Loading composer repositories或Downloading；正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需严格满足键名、type值和末尾斜杠三要素。
换镜像源不是“可选优化”，而是国内 PHP 开发者执行 composer install 前必须做的第一步。不配，大概率卡在 Loading composer repositories 或 Downloading，和你本地网络无关。
确认当前用的是哪个源
直接运行：composer config -g repo.packagist。输出应为类似 "https://mirrors.aliyun.com/composer/" 的字符串。如果为空、null、或仍是 "https://packagist.org"，说明没生效。
- 旧版 Composer（1.x）不识别
repo.packagist，得用：composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 输出是完整 JSON 对象（含
"type": "composer"）更稳妥；新版可能只返回 URL 字符串，只要不是空或官方地址就算对 - 别信
composer diagnose的“OK”提示——它不校验镜像是否真被读取，-vvv日志才是铁证
全局配置阿里云镜像（最常用）
一条命令搞定，所有项目默认走镜像：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/ - 注意三个硬性要求：键名必须是
repo.packagist（不能多 s、不能少repo.），中间的composer是 type 值（不可省），URL 末尾必须带斜杠/ - 配完立刻生效，不用重启终端；但首次
composer install仍慢——这是 Composer 在重建本地元数据索引，后续才提速 - 若报
Could not open input file: composer，说明composer没进 PATH，先查安装路径（比如/usr/local/bin/composer），补环境变量
为什么换了镜像还卡在 Resolving dependencies
这个阶段不走网络，纯本地计算，慢跟镜像无关。真实瓶颈通常在 PHP 环境：
-
COMPOSER_MEMORY_LIMIT过低（默认常为 128M），尤其大项目会反复重试——临时加COMPOSER_MEMORY_LIMIT=-1再试 - 启用了
xdebug（php -v能看到 xdebug 字样），会让依赖解析慢 5–10 倍——用php -d xdebug.mode=off $(which composer) install临时禁用 -
composer.json里"platform"声明的 PHP 版本（如"php": "7.4"）和实际运行版本（php -v）不匹配，触发降级查找逻辑 -
composer.lock里残留已下线包的引用，导致回退搜索——删掉vendor/和composer.lock，再composer install --no-cache
项目级配置与临时切换（CI/协作必备）
全局配置在 CI 或团队协作中不可靠（不同用户、不同系统 PATH、宝塔/www 用户权限隔离），必须写进项目本身：
- 进入项目根目录，运行：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不加-g） - 该命令自动向
composer.json的repositories数组追加 packagist 镜像项，不破坏已有私有源 - 改完必须删
vendor/和composer.lock，再跑composer install（不是update），否则新源不生效 - 临时调试单次命令，用
--repository参数优先级最高：composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/，-vvv日志里能看到真实请求域名
镜像同步有延迟（通常 5–30 分钟），新发布的包可能还没到镜像站；私有 repositories、path 类型依赖、或废弃包（abandoned）会绕过镜像直连官方源——这些情况 -vvv 日志里都能一眼识别。
