华为云镜像配不生效主因是键名错（repo.packagist非repos.packagist）、缺type值、URL末尾斜杠缺失；需同时满足全局配置正确、无项目级repositories覆盖、启用parallel-downloads并发下载。
华为云镜像源配不生效，90% 是因为 repo.packagist 键名写错、composer 类型值漏掉，或 URL 少了末尾斜杠——不是网络慢，是根本没走镜像。
确认命令是否写对：三个硬性条件缺一不可
全局配置只有一条有效命令，错一个字符就静默失效：
-
repo.packagist不能写成repos.packagist（多一个 s 就完全忽略） - 必须显式带上
composer作为 type 值，不能只写 URL - URL 必须是
https://mirrors.huaweicloud.com/repository/php/composer/（注意路径含/repository/php/composer/，结尾斜杠 不能省）
正确执行后，运行 composer config -g repo.packagist 应输出完整 JSON，例如：
{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/"}若为空、报错或只输出 URL 字符串，说明配置未写入。
检查是否被项目级 repositories 覆盖
Composer 源优先级永远是：项目级 > 全局 > 默认。只要当前目录下 composer.json 里有 repositories 字段，全局配置就自动作废。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"repositories": {}（空对象）也会屏蔽全局镜像 -
"repositories": []（数组）会导致后续composer config命令直接报错 - 安全写法是显式定义
"packagist"key："repositories": { "packagist": { "type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/composer/" } } - 别手写改
composer.json后再跑composer config，容易格式错乱；想删项目级配置，用composer config --unset repositories.packagist
必须启用 parallel-downloads 并设合理并发数
镜像只解决“连得上”，不解决“跑不满带宽”。Composer 2.2+ 默认仅开 3 个并发线程，相当于把千兆宽带压成百兆用。
- 执行
composer config -g parallel-downloads 8（推荐 6–10，视机器 CPU 核心数调整） - 旧版 Composer 不支持该参数，先升级：
composer self-update - 验证是否生效：
composer config -g parallel-downloads应输出数字，不是null或空
不开这个，换再快的镜像也卡在 downloading 阶段不动。
缓存和同步延迟：两个容易被忽略的现实约束
华为云镜像同步有 5–30 分钟延迟，新发布的包可能暂时拉不到；本地缓存路径不可写或未启用，也会导致每次重下 ZIP 包。
- 若报
The "https://repo.huaweicloud.com/.../package.json" file could not be downloaded (HTTP/2 404)，大概率是同步延迟，不是你配错了 - 临时切阿里云镜像应急：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 确认缓存路径可写：
composer config -g cache-files-dir，若为空，补上：composer config -g cache-files-dir ~/.composer/cache/files - CI 环境中必须同时缓存
~/.composer/cache和vendor/，否则 PHP 小版本微调就会触发全量重装
真正提速不是换一个 URL 就完事，而是三件事一起做：配对写对、跳过覆盖、并发拉满——少一个环节，下载速度就卡在原地。
