composer下载慢的根本原因是默认连接海外packagist.org导致dns解析慢、tls握手卡顿、首字节延迟高，换国内镜像源是必须第一步而非可选优化；正确配置需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（键名单数、type值为composer、url以/结尾），验证须运行composer config -g repo.packagist输出完整url，空/null或仍为packagist.org即失效，且项目级repositories字段会覆盖全局配置。
composer 下载慢，不是你网络差，而是默认走 packagist.org —— DNS 解析慢、TLS 握手卡、首字节延迟高，换国内镜像源是必须做的第一步，不是“可选优化”。
确认当前镜像是否生效
执行 composer config -g repo.packagist，输出应为类似 "https://mirrors.aliyun.com/composer/" 的完整 URL。如果为空、null 或仍是 "https://packagist.org"，说明没生效。
-
repo.packagist（单数）是 Composer 2.0+ 唯一认的键名；旧版 1.x 才用repos.packagist（复数），设错就静默失效 - 别手写
~/.composer/config.json，格式错一个逗号，composer命令直接报file_get_contents(): Failed to open stream - 项目级
composer.json里若有"repositories"字段，会完全覆盖全局镜像——这是最常被忽略的失效原因
临时切换镜像（单次命令有效）
适合 CI 脚本、验证新包、绕过公司代理，不改任何配置：
- 加
--repository-url参数：例如composer install --repository-url https://mirrors.aliyun.com/composer/ -
require命令不认--repository-url，只能用create-project或update测试 - 必须加
-vvv看日志：运行composer install -vvv 2>&1 | grep "Downloading"，确认 URL 域名是mirrors.aliyun.com才算真走镜像 - 注意：镜像同步有延迟（阿里云通常 5–10 分钟），刚发布的包可能还没同步，报
Could not find package是正常现象
永久配置镜像并避免踩坑
推荐方式是全局配置，但细节决定成败：
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/（末尾斜杠不能少） - 别用
http://地址，除非内网明确拦截 HTTPS；http://mirrors.aliyun.com/composer/在多数环境会失败 - 升级到
composer self-update至 2.5+，旧版（尤其 1.x）不支持 HTTPS 镜像，卡在Loading composer repositories...就是它 - 清缓存再验证：
composer clear-cache，否则旧的损坏元数据可能让镜像“看起来生效实则无效”
换了镜像还是慢？先看这三件事
镜像只加速下载，不解决依赖解析卡顿。如果卡在 Resolving dependencies，和镜像无关：
- PHP 内存不足（默认 128M）：临时加
COMPOSER_MEMORY_LIMIT=-1 composer install - xdebug 启用中：运行
php -d xdebug.mode=off $(which composer) install测试 -
composer.lock里残留已下线包，或platform配置与实际 PHP 版本不匹配（如声明"php": "7.4"却在 PHP 8.2 上跑）
真正容易被忽略的是：镜像生效 ≠ 全流程变快。下载快了，但依赖图太深、本地 PHP 环境拖后腿，照样卡住不动。
