阿里云镜像失效后需手动切换镜像源并清缓存，否则 composer install 会卡死；推荐腾讯云镜像（自动 fallback），执行 composer config -g repositories.packagist.org 配置并紧跟 composer clear-cache；项目级配置更可靠，注意键名兼容性与缓存清理。
阿里云镜像源失效后，不能指望 Composer 自动切到腾讯云或华为云——它根本没这个能力。必须手动换源 + 清缓存，否则 composer install 会卡死在 Downloading https://mirrors.aliyun.com/composer/packages.json，不报错、不重试、不 fallback。
怎么确认阿里云源真挂了
别重试三次就放弃，先看真实行为：
- 运行
composer install -vvv，盯住最后几行：如果反复出现Reading packages.json from cache后无响应，或最终请求路径是https://packagist.org/packages.json，说明镜像没生效或已不可用 - 执行
composer config -g repositories.packagist.org，输出必须是完整 JSON，比如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果为空、null或仍是旧地址（如已下线的https://packagist.phpcomposer.com），配置已失效 - 检查项目根目录
composer.json是否含"repositories"字段——只要存在，哪怕为空数组，全局配置就彻底被屏蔽
三步切换到腾讯云镜像（推荐 fallback 容错）
腾讯云镜像默认开启回源，找不到包时会自动 fallback 到 packagist.org，适合装新发布或小众包，比阿里云更省心：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行命令：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}'（注意：URL 必须以/结尾，否则 Composer 2.5+ 报Invalid repository type） - 立刻清缓存：
composer clear-cache—— 这步不能省，否则本地缓存的packages.json仍指向阿里云 - 验证是否生效：
composer diagnose输出中 “Repo:” 后应显示https://mirrors.cloud.tencent.com/composer/；也可跑一次composer show -s | head -n 3看源域名
华为云或中科大镜像作为备选方案
华为云稳定性高但部分企业防火墙拦截其域名；中科大镜像适合教育网环境，普通宽带反而慢。切换时注意路径差异：
- 华为云（路径含
/repository/php/）：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/"}' - 中科大镜像（同步略延迟）：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://packagist.mirrors.ustc.edu.cn/"}' - 所有命令后必须跟
composer clear-cache，否则缓存元数据不变，换源等于白换
项目级切换更可靠，尤其团队协作时
全局配置在 CI/CD 或多项目混用时容易出问题，composer.lock hash 不一致会导致部署失败。项目级写法才真正可控：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/（不加-g） - 前提是
composer.json中"repositories"是对象（如{"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动改为对象格式 - 提交
composer.json到 Git，新人拉代码后行为完全一致；换源后若报 hash 不匹配，删掉vendor/和composer.lock重来
最常被忽略的是缓存清理和键名版本兼容性：repositories.packagist.org 是 Composer 2.2+ 的标准键名，用 repo.packagist 在新版里会被静默忽略；而 composer clear-cache 只清本地文件，不重载配置——这两点同时出错，换源就永远不生效。
