Composer国内源切换：从入门到环境精通-composer-PHP中文网

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但 90% 失败源于漏 -g、键名写成 repos.packagist 或 url 缺末尾 /，任一错误均静默回退官方源；验证需三处一致：config 输出、diagnose 显示、-vvv 日志均为镜像地址。

composer国内源切换：从入门到环境精通

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但 90% 的失败不是网络问题，是命令漏掉 -g、键名写成 repos.packagist、或 URL 缺末尾 / —— 三者任一出错，Composer 都静默 fallback 到官方源，且完全不报错。

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

不是命令没运行，而是 Composer 2.x 硬编码只认 repo.packagist（单数、全小写、无 s），写错就存进无效字段，查出来是空或 null：

repos.packagist、packagist.org、Repo.Packagist 全部无效
漏掉 composer 这个 type 值 → fallback 到 packagist.org，等于白配
URL 是 https://mirrors.aliyun.com/composer（缺 /）→ 请求路径拼成 /composerpackages.json，直接 404
没加 -g → 只改当前项目 composer.json，换目录就失效

验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。

Composer 2.2+ 推荐用 `repositories.packagist.org` 键名

旧键名 repo.packagist 在部分新版中会被静默忽略，尤其 CI 环境或宝塔面板下更易踩坑。兼容性更强的写法是：

Discussion Composer

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

下载

设阿里云：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
设腾讯云：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}'
恢复官方源：composer config -g --unset repositories.packagist.org

注意：value 必须是合法 JSON 字符串（单引号包裹整个 JSON，内部双引号不能省），否则会报 JSON decode error。

项目级配置比全局更可靠，怎么安全追加？

团队协作或 CI 场景下，全局配置容易被覆盖或权限错位（比如宝塔用 www 用户跑命令，但 -g 写的是 root 的配置）。推荐进项目根目录后执行：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）
它会自动 merge 到 composer.json 的 "repositories" 字段中，key 固定为 "packagist"
前提：原 "repositories" 是对象格式（如 {"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动转成对象
提交 composer.json 到 Git，新人拉代码后 composer install 自动走镜像，composer.lock hash 一致

换源后必须执行 `composer clear-cache`

缓存不清理，元数据仍从旧源加载，导致 composer install 看似走新地址，实则请求发往旧域名。验证是否真生效，不能只信命令回显，要看三处：

composer config -g repo.packagist.url 或 composer config -g repositories.packagist.org 输出是否为你设的镜像地址
composer diagnose 中 “Repo:” 行显示的域名是否匹配
composer update -vvv 日志里 Downloading 的 URL 是否含 mirrors.aliyun.com

最常被忽略的是：composer.lock 里记录的是原始 packagist.org 的 dist URL，首次切换后建议加 --lock 强刷一次，或删掉 vendor/ 和 composer.lock 重装。