直接换镜像源并立刻执行composer clear-cache最有效；90%失败源于镜像失效或缓存未更新，非网络问题；composer config -g repo.packagist需同时满足：键名单数repo、type值为composer、url以/结尾，三者缺一即静默回退官方源。
直接换镜像源并立刻执行 composer clear-cache，比反复重试有效得多；90% 的安装失败或卡顿，根源是镜像失效或缓存未更新，不是你本地网络问题。
composer config -g repo.packagist 命令为什么总不生效
不是命令输错了，而是三个硬性条件缺一不可：
-
repo.packagist必须是单数（不是repos.packagist或repositories.packagist.org），拼错就静默写进无效字段 - 命令末尾必须显式带上
composer类型标识，漏掉它会 fallback 到https://packagist.org -
url必须以/结尾：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（路径拼成/composerpackages.json直接 404）
验证方式只有一条：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、含 packagist.org，都说明没配成功。
项目级配置比全局更可靠，怎么安全追加
进项目根目录后执行（注意不加 -g）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/。它会自动合并到 composer.json 的 "repositories" 字段中，key 固定为 "packagist"。
但有两个前提：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 原
"repositories"必须是对象（如"repositories": { "packagist": {} }），不是数组；否则命令报错，需先手动转成对象 - 如果已有私有仓库，该命令不会覆盖，只会安全 merge —— 适合团队协作和 CI 环境，配置可被 Git 跟踪
一旦 composer.json 里存在 "repositories" 字段（哪怕只是空数组），全局配置就完全失效，这是 Composer 的硬性优先级规则。
换源后 composer install -vvv 还在请求 packagist.org？查这三处才靠谱
不能只信命令回显“成功”，得看真实行为是否切换：
- 查配置：
composer config -g repo.packagist.url输出必须是你设的镜像地址，不是空、不是packagist.org - 看诊断：
composer diagnose，找到 “Repo:” 那行，域名必须匹配你配的镜像（如mirrors.aliyun.com） - 抓请求：
composer update -vvv 2>&1 | grep -i downloading，日志里出现的 URL 必须含镜像域名，且路径以/p2/或/packages.json结尾
如果这三项都对，但下载仍慢或失败，大概率是本地环境问题：DNS 解析异常、CA 证书过旧、PHP curl 扩展缺失或 OpenSSL 版本太低——这些和镜像无关，但会导致 HTTPS 握手失败，表现为“超时”。
最常被忽略的一步是清缓存；镜像同步本身有 5–30 分钟延迟，新发布的包可能还没同步，别急着换源，先用 composer show vendor/package -vvv 看真实请求域名再判断。
