阿里云镜像可解决90% composer下载问题，配置需满足三要素：键名为repo.packagist（单数）、末尾带composer类型标识、url以/结尾；验证输出必须为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
直接用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能解决 90% 的下载卡顿、超时和 404 问题；阿里云镜像是目前唯一持续全量同步、HTTPS 可靠、索引完整且仍在维护的国内源。
为什么 composer config -g repo.packagist 没生效
不是网络或命令输错，而是三个硬性条件缺一不可：
-
repo.packagist必须是单数repo（不是repos或repositories），拼错就静默写进无效字段 - 命令末尾必须显式带上
composer类型标识，省略它会导致 Composer fallback 到默认源 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（路径拼接错误直接 404）
验证方式只有一条：composer config -g repo.packagist 输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错，都说明没写对。
Composer 2.2+ 版本下该用哪个键名
新版推荐 repositories.packagist.org，但实际中更推荐继续用兼容性更强的 repo.packagist：
-
repo.packagist在 1.x 和绝大多数 2.x（包括 2.5.x）中仍被完整支持，无需版本判断 -
repositories.packagist.org要求 JSON 字符串格式：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'，引号和转义易出错 - 项目级
composer.json中只要存在"repositories"字段（哪怕为空数组），全局配置就会被完全忽略——这点和键名无关，只和作用域优先级有关
所以别为“新不新”纠结，盯住 repo.packagist + 正确三要素，最稳。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后还是走 packagist.org？查这三处才靠谱
不能只信命令回显“成功”，得看真实行为是否切换：
- 查配置：
composer config -g repo.packagist.url或composer config -g repositories.packagist.org，输出必须是你设的镜像地址，不是空、不是packagist.org - 看诊断：
composer diagnose，找到 “Repo:” 那行，域名必须匹配你配的镜像（如mirrors.aliyun.com） - 抓请求：
composer update -vvv 2>&1 | grep -i downloading，日志里出现的 URL 必须含镜像域名，且路径以/p2/或/packages.json结尾
如果前三步都对，但下载仍慢或失败，大概率是本地环境问题：DNS 解析异常、CA 证书过旧（cURL error 60）、或 CI 中用了 sudo composer config -g 写进了 root 用户配置，而构建进程用的是普通用户。
项目级配置比全局更可控，但要注意 key 名和合并逻辑
进项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）：
- 它会自动在
composer.json顶层写入"repositories": {"packagist": {...}}，key 必须是packagist（不能改成aliyun或其他），否则不被识别为默认源覆盖 - 如果项目已有
"repositories": {}或"repositories": []，这条命令会安全合并（前提是原值是对象），不会覆盖私有源 - 删项目级配置别手改 JSON，用
composer config --unset repos.packagist，避免格式损坏导致composer validate报错
项目级配置优先级高于全局，适合团队协作、CI/CD 或需要多源共存的场景；但切记：一旦写了，全局设置就彻底失效——这不是 bug，是 Composer 明确定义的行为。
