直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/可解决90%下载问题，三要素缺一不可：键名必须为repo.packagist（非复数）、中间composer为强制type值、url末尾必须带/；验证需输出完整json {"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.json 里已有 repositories 字段，还能用全局镜像吗
不能。只要项目级 composer.json 中存在 "repositories" 字段（哪怕只是空对象 {} 或空数组 []），全局配置就会被完全忽略——这点和键名无关，只和作用域优先级有关。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果
"repositories"是对象（如"repositories": { "my-private": { ... } }），可用composer config repo.packagist composer https://mirrors.aliyun.com/composer/安全追加 - 如果它是数组（如
"repositories": []），命令会报错；必须先手动改成对象格式再运行 - 别手写
"packagist.org": false，这会彻底关掉官方源，一旦镜像临时不可用，composer install直接失败
换源后还是走 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 证书过旧，或公司代理屏蔽了镜像域名。
临时验证镜像是否可用，不改任何配置
加 --repository-url 参数，它优先级最高，会强制覆盖全局和项目级所有仓库配置：
- 只对
install、update、require命令生效（注意不是composer require foo/bar后加参数，而是composer require命令前加） - 必须加
-vvv才能看到真实请求地址，比如日志中出现GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json才算真正走镜像 - 示例：
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/
这个方式适合排查问题，也适合 CI 环境中避免污染全局状态。但要注意：它不会影响 composer.lock 的生成逻辑，若后续用其他源重装，hash 可能不一致。
