Composer镜像配置失败主因是字段名错误、类型缺失和URL缺斜杠；正确命令为composer config -g repo.packagist composer https://...，且URL须以/结尾，验证需输出完整JSON对象。
国内 Composer 镜像不是“换一个 URL 就完事”，配错字段名、少个斜杠、用错协议，composer install 依然会默默回退到 packagist.org，你以为切成功了，其实没生效。
为什么 composer config -g repo.packagist 总是不生效？
绝大多数失败不是网络问题，而是命令写错三个关键点：
-
repo.packagist不能写成repos.packagist（多一个s）——Composer 完全忽略，也不报错 - 必须显式声明
composer类型，不能只写 URL：composer config -g repo.packagist composer https://...✅；... repo.packagist https://...❌ - URL 必须以
/结尾，否则路径拼接错误：比如https://repo.huaweicloud.com/repository/php会变成.../phppackages.json，直接 404
验证是否真生效：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写对。
阿里云 vs 华为云：URL 和可用性差异
两者都是全量实时镜像，但地址结构和稳定性细节不同：
- 阿里云地址是
https://mirrors.aliyun.com/composer/，末尾斜杠必须有；DNS 解析快，电信用户延迟最低（实测平均 38ms） - 华为云当前唯一有效地址是
https://repo.huaweicloud.com/repository/php/（注意不是mirrors.huaweicloud.com，后者已 404）；移动网络下下载速度略优（实测 4.0MB/s），同步标注为“实时” - 腾讯云地址为
https://mirrors.cloud.tencent.com/composer/，部分地区偶发 DNS 解析慢，但整体可用性最高（99.5%）
别信旧教程里带 mirrors.huaweicloud.com 的链接——2026 年起已全部失效，硬配只会卡在 404。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更安全，尤其适合协作
全局配置看着省事，但一旦你参与的开源项目要求走官方源，或 CI 流水线里混用镜像，就容易触发 hash 不一致、依赖解析失败等问题。
- 进项目根目录，运行：
composer config repo.packagist composer https://repo.huaweicloud.com/repository/php/ - 这条命令会自动在
composer.json顶层加"repositories"字段，key 必须是"packagist"，不能改成"huawei"或其他别名 - 如果项目已有
"repositories"，别手动覆盖——用命令追加，否则可能误删私有包源 - 想删掉？别手改 JSON，运行：
composer config --unset repos.packagist（注意是repos.packagist，这里是复数，因为它是repositories下的子项）
项目级配置优先级高于全局，拉代码即生效，行为可预测。
换源后还是慢？别怪镜像，先看这三处
镜像只加速下载，不解决依赖解析本身的问题：
-
composer update卡在Resolving dependencies？大概率是composer.json里 PHP 版本约束太宽（如"php": "^7.4 || ^8.0"）、dev 包未锁定、require-dev 塞太多工具链 - 本地启用了 Xdebug？执行前加
XDEBUG_MODE=off，例如：XDEBUG_MODE=off composer create-project laravel/laravel test - 首次换源后
install报 hash 校验失败？删掉vendor和composer.lock重来即可，这是正常现象
真正容易被忽略的是：项目级配置里的 key 名、URL 末尾斜杠、以及 repos.packagist 和 repo.packagist 这种只差一个字母的字段名——它们不会报错，但会让整个配置静默失效。
