换镜像可解决 composer 安装卡在“loading composer repositories”的问题，关键需同时满足三条件：键名必须为 repo.packagist（单数）、type 值显式指定为 composer、url 必须是 https 且末尾带斜杠。
composer install 卡在 “Loading composer repositories” 或反复重试下载，不是你网络差，是默认源 https://packagist.org 在国内解析慢、TLS 握手不稳定、CDN 距离远——换镜像就能解决，但配错一个字符就等于没配。
全局配置命令必须写对这三处，否则静默失效
90% 的“配了还是慢”问题，都出在这三个硬性要求上，缺一不可：
-
repo.packagist是唯一合法键名（注意是 repo 单数，不是repos.packagist或packagist.org） - 必须显式传入
composer作为 type 值：命令里漏掉它，Composer 2.x 会直接 fallback 到官方源 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼成/composerpackages.json，404）
正确命令示例：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
composer config -g repo.packagist
输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串；空、null、或仍是 https://repo.packagist.org，说明根本没写进去。
项目级配置比全局更可靠，尤其在团队和 CI 中
全局配置容易被覆盖或权限不一致（比如宝塔用 www 用户执行，而 -g 配的是 root），项目级配置写进 composer.json，拉代码即生效，行为可预期：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
（注意：不加-g） - 该命令会自动向
composer.json的repositories字段追加"packagist"条目，不会清空已有私有源 - 如果
composer.json原本是"repositories": {}，命令会转为标准数组格式并插入；如果是"repositories": []，则追加到数组末尾 - 改完后务必运行：
composer update --lock
，让composer.lock记录新源地址
换源后仍卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不解决依赖求解慢的问题。如果你发现 composer update 卡在 Resolving dependencies 超过 10 秒，大概率是以下原因：
-
php版本约束太宽，例如"php": "^7.4 || ^8.0"，触发组合爆炸 - 写了模糊版本号，如
"monolog/monolog": "*"或"dev-main" -
require-dev里塞了大量未锁定的工具包 - 启用了
xdebug（会拖慢 Composer 求解器数倍） -
composer.lock过旧，导致版本重算开销大
此时加镜像毫无作用，应先执行：
composer update --lock轻量更新 lock 文件，再检查
composer.json 中的约束是否合理。
验证镜像是否真在用，别信日志“跑完了”
光看命令没报错没用，得亲眼确认请求发到了镜像域名：
- 删掉
vendor/和composer.lock - 执行：
composer install -vvv
- 观察日志里所有
GET请求的域名，必须出现mirrors.aliyun.com或对应镜像域名（如mirrors.tuna.tsinghua.edu.cn） - 如果仍有
packagist.org或repo.packagist.org出现，说明镜像未生效，回溯前几步检查键名、type、URL 格式
真正容易被忽略的是：换源后首次 install 仍可能较慢——这是 Composer 在重建本地元数据缓存索引，后续操作才会明显提速；另外，某些包（如标记为 abandoned 的）或使用了 path 类型仓库的依赖，会绕过镜像直连原始源，属正常行为。
