Composer中文镜像与原版源之间如何自由切换（命令汇总）-composer-PHP中文网

必须严格使用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/命令，三要素缺一不可：-g（全局）、repo.packagist（单数键名）、composer（type值）及末尾带/的https url，否则静默失效。

composer中文镜像与原版源之间如何自由切换（命令汇总）

composer config -g repo.packagist 命令能立刻切换中文镜像，但90%失败不是因为网络慢，而是漏 -g、键名写成 repos.packagist、或 URL 少了末尾 /——三者任一出错，Composer 都静默走官方源，且不报错。

怎么用一行命令切到阿里云/腾讯云/华为云镜像

所有命令必须带 -g、键名严格为 repo.packagist、composer 作为 type 值、URL 以 https:// 开头且结尾带 /：

阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
腾讯云：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
华为云：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
中科大（USTC）：composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/

清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会触发 Curl error 60 或 Could not resolve host。

为什么 `composer config -g repo.packagist` 总不生效

不是命令没运行，是 Composer 2.x 硬编码只认这个 exact key：repo.packagist（单数、全小写、无 s），写错就存进无效字段，查 composer config -g repo.packagist 输出为空或 null：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

漏 -g → 只改当前项目 composer.json，换目录即失效
键名写成 repos.packagist 或 packagist.org → 配置被忽略
URL 缺末尾 / → 请求路径拼成 /composerpackages.json，直接 404
漏掉 composer 类型参数 → fallback 到 https://packagist.org
没执行 composer clear-cache → 本地元数据仍指向旧源

如何安全恢复官方源或临时绕过镜像

恢复默认不是“删配置”，而是显式取消自定义源：

恢复官方源：composer config -g --unset repo.packagist
临时单次命令走镜像（不改任何配置）：composer update -vvv --repository=https://mirrors.aliyun.com/composer/
仅当前项目启用镜像（Git 可跟踪）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）
验证是否真生效：composer config -g repo.packagist 输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

Composer 2.2+ 用户要注意键名兼容性

新版推荐用 repositories.packagist.org 替代 repo.packagist，避免静默忽略：

设阿里云：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
查配置：composer config -g repositories.packagist.org（输出应为 JSON 字符串，不是空）
项目级 composer.json 中的 repositories 字段会覆盖全局配置，哪怕你全局配了也无效
Windows 下 Git Bash 用户需确认 COMPOSER_HOME 是否生效，否则实际读的是 %APPDATA%\Composer\config.json

最易被忽略的一点：无论用哪个键名，composer clear-cache 必须手动执行一次，否则缓存里的元数据不会更新，命令看似成功，实际请求仍发往旧地址。