composer 2.9.6+是唯一稳定支持华为云镜像的版本，必须用composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/配置，地址末尾斜杠不可省，且需验证输出为完整json对象。
确认当前 Composer 版本是否支持华为云镜像
Composer 2.9.6+ 是唯一能稳定对接华为云镜像的版本。低于这个版本（尤其是 2.8.x 或更早）会因 repo.packagist 字段解析逻辑差异或 HTTPS 路径拼接失败，导致配置静默失效或报 404。
运行 composer --version 查看；若输出不是 2.9.6 或更高，必须先升级：composer self-update。如果提示 Permission denied，说明 ~/.composer/ 权限错乱，改用：chown -R $USER:$USER ~/.composer。
华为云镜像地址必须用对，一个字符都不能错
截至 2026 年 7 月，唯一实测可用的地址是：https://repo.huaweicloud.com/repository/php/（注意末尾斜杠 ✅）。
以下全是错误写法，会直接导致 composer install 卡住或返回 404：
-
https://mirrors.huaweicloud.com/repository/php/—— 已 404 -
https://repo.huaweicloud.com/composer/—— 缺少/repository/php/路径 -
https://repo.huaweicloud.com/repository/php—— 少末尾斜杠，路径拼接失败 -
http://repo.huaweicloud.com/repository/php/——secure-http=true默认拦截 HTTP
全局配置命令只有一条，别加多余参数
直接在终端执行这一行即可生效：composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/。
关键点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist不能写成repos.packagist（多一个s就被完全忽略） -
composer是 type 值，不能省——否则会被当成 VCS 源处理 - 不需要
--unset、不用手动关secure-http、也不用提前clear-cache - 验证是否成功：运行
composer config -g repo.packagist，应直接输出完整 URL
项目级配置比全局更安全，适合协作和 CI
如果你在团队开发、CI/CD 流水线或混合环境（比如本地用阿里云、测试服跑华为云），建议放弃全局配置，改用项目级：
进项目根目录，运行：composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/。
这条命令会自动往 composer.json 的 repositories 字段里加一条 "packagist" 键值，且优先级高于全局配置。
注意：
- key 名必须是
packagist，不能改成huawei或其他名字 - 已有
repositories字段时，命令会自动 merge，不会覆盖私有源 - 想删掉它？别手动编辑
composer.json，用：composer config --unset repos.packagist
换源后首次 composer install 若报 hash 不匹配，删掉 vendor 和 composer.lock 重来就行。真正容易被忽略的是：一旦项目级配置存在，全局 repo.packagist 就彻底失效——这点不检查 composer.json 很难发现。
