答案是命令未满足三个硬性条件：键名必须为单数小写repo.packagist、中间composer为必填type值、URL须HTTPS且末尾带斜杠；任一缺失均静默回退官方源。
composer config -g repo.packagist 命令为什么总不生效
这条命令看似简单，但 90% 的失败是静默的——composer install 还是连 packagist.org，日志里看不到任何报错。根本原因就三个硬性条件缺一不可：
-
repo.packagist必须是单数、全小写、无额外字母；写成repos.packagist或packagist.org就存进无效字段，查composer config -g repo.packagist会返回空或null - 中间的
composer是type值，不是注释，不能省，也不能替换成composer.org或其他字符串 - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.huaweicloud.com/repository/php/✅，少斜杠会拼出/composerpackages.json导致 404
华为云镜像地址和命令必须严格匹配
截至 2026 年 7 月，唯一实测稳定可用的地址是：https://mirrors.huaweicloud.com/repository/php/（注意不是 repo.huaweicloud.com，也不是 /composer/ 结尾）。旧教程里的 https://mirrors.huaweicloud.com/composer/ 和 https://repo.huaweicloud.com/composer/ 均已返回 404。
全局配置只有一条命令，大小写、空格、顺序都不能错：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/
验证是否写入成功，直接运行：
composer config -g repo.packagist
正确输出应为：
{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/"}
项目级配置比全局更可靠，尤其在协作和 CI 场景
全局配置只对当前用户生效，但在多用户环境（如宝塔、Docker、华为云 DevCloud 流水线）中极易失效：Web 服务可能以 www 用户运行，而你用普通用户配了全局，实际执行时根本读不到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
推荐做法是进项目根目录，执行（不加 -g）：
composer config repo.packagist composer https://mirrors.huaweicloud.com/repository/php/
该命令会自动向 composer.json 写入标准结构：
"repositories": { "packagist": { "type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php/" } }
注意："packagist" 是固定 key 名，不能改成 "huawei" 或其他名字；如果已有 "repositories" 字段，命令会安全追加，不会覆盖私有源。
换源后仍卡住？清缓存和旧文件是关键动作
Composer 会优先读取本地缓存和 composer.lock 中记录的元数据地址。哪怕你刚配好镜像，它也可能还在用旧 URL 请求官方源。
必须做三件事：
- 运行
composer clear-cache删除旧元数据缓存 - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志中Downloading行的域名是不是mirrors.huaweicloud.com
同步延迟通常在 5 分钟内，不是实时，但足够覆盖日常开发节奏。真正容易被忽略的是：项目级 repositories 字段只要存在（哪怕是空对象 {}），就会屏蔽全局配置，且完全不提示。
