华为云镜像配置必须同时满足三个硬性条件：键名严格为repo.packagist、type值显式写composer、url为https://repo.huaweicloud.com/repository/php/（含末尾斜杠），缺一即静默回退官方源。
配华为云镜像源不是“换地址就行”，而是必须同时满足三个硬性条件：键名是 repo.packagist、type 值是 composer、URL 是 https://repo.huaweicloud.com/repository/php/（注意结尾斜杠）——三者缺一不可，错一个字符就静默失效。
为什么 composer config -g repo.packagist 不生效
常见现象是命令执行无报错，但 composer install 仍连 packagist.org 或卡在下载阶段。根本原因不是网络问题，而是配置没被 Composer 识别：
-
repo.packagist写成repos.packagist（多一个 s）——Composer 源码里硬编码只认这个 key，拼写错就完全跳过，不提示也不报错 - 漏掉
composer这个 type 参数，例如写成composer config -g repo.packagist https://...，会被当成 vcs 源处理，后续请求直接失败 - URL 用了
http://协议，触发 Composer 默认的secure-http=true拦截，连接被拒绝 - 执行命令时用户权限不对，比如用
sudo运行，结果写到了 root 的~/.composer/config.json，而当前用户读的是自己的配置文件
验证是否真生效：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://repo.huaweicloud.com/repository/php/"} 的 JSON 对象。空、null、报错或只显示 URL 字符串，都说明没配对。
项目级配置比全局更可靠，但写法有陷阱
多人协作或 CI 环境中，全局配置容易引发 composer.lock hash 不一致。推荐进项目根目录执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/
这条命令会自动在 composer.json 顶层写入 repositories 字段。但要注意：
- key 必须是
"packagist"，不能改成"huawei"、"aliyun"或其他名字，否则 Composer 不识别为默认源覆盖 - 如果项目已有
"repositories": {}（空对象），它也会屏蔽全局镜像，必须删掉或重写为合法结构 - 不要手动编辑
composer.json后再跑composer config，容易格式错乱；想删配置，用composer config --unset repos.packagist - 一旦写了项目级
packagist，全局配置自动失效，优先级最高
换源后还是慢？检查 parallel-downloads 和缓存
镜像只加速下载，不解决并发瓶颈。Composer 2.2+ 默认只开 3 个并发线程，相当于把千兆带宽压成百兆用：
- 启用高并发：运行
composer config -g parallel-downloads 8（推荐值；设为 10 容易触发临时文件竞争） - 该设置只对
composer install生效；composer update仍需串行解析依赖图，本质无法完全并发 - 旧缓存里可能存着官方源的元数据，不清掉会继续尝试连接：执行
composer clear-cache - 换源后首次
composer install若报 hash 校验失败，必须删掉vendor和composer.lock重来，否则残留的锁文件会强制拉旧版本
华为云当前唯一可用地址是 https://repo.huaweicloud.com/repository/php/
网上大量教程写的 https://mirrors.huaweicloud.com/... 地址已全部返回 404。别试，也别凑合——少一个字符、多一个路径段、漏掉末尾斜杠，都会 404：
- ✅ 正确：
https://repo.huaweicloud.com/repository/php/ - ❌ 错误：
https://mirrors.huaweicloud.com/repository/php/（mirrors.前缀已停用） - ❌ 错误：
https://repo.huaweicloud.com/repository/php（缺结尾斜杠，路径拼接出错） - ❌ 错误：
https://repo.huaweicloud.com/composer/（路径错误，缺少/repository/php/）
同步延迟极低，官方标注“实时同步”，但真正卡点往往不在镜像本身——而是你本地的 composer.json 里混写了多个 repositories、或企业网络劫持了 HTTPS 请求。先跑 composer diag 看 Available repositories 行输出是否匹配你配的地址，再往下排查。
