详解阿里云Composer镜像源同步配置-composer-PHP中文网

composer config -g repo.packagist 命令必须同时满足三要素：键名严格为 repo.packagist（单数）、第二个参数必须是 type 值 composer、url 必须 https 且末尾带 /，缺一即静默失效；验证需输出完整 json 如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

详解阿里云composer镜像源同步配置

composer config -g repo.packagist 命令必须三要素齐全

这条命令不是“试试看”，而是严格要求三个要素同时存在：键名 repo.packagist、type 值 composer、URL 末尾带斜杠。漏掉任意一个，Composer 就静默忽略，composer install 仍走 packagist.org，你只会觉得“换源没用”。

repo.packagist 不能写成 repos.packagist（多一个 s 就完全不生效）
composer 是 type 字段值，不是命令名，不能省略或写成空字符串
URL 必须是 https://mirrors.aliyun.com/composer/（结尾斜杠不可少；HTTP 地址在 Composer ≥2.2 中会被拒绝）

正确命令只有一行，建议直接复制执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否真生效，别信“执行完就 OK”

仅靠“好像快了”或“没报错”无法判断镜像是否启用。必须同时满足三项验证：

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 repo.packagist，输出必须是完整 JSON 对象，形如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
运行 composer diagnose，检查 “Repo” 行是否显示阿里云地址；若仍是 https://packagist.org，说明被项目级 repositories 覆盖
运行 composer install -vvv 2>&1 | grep "Downloading"，日志中出现的域名必须是 mirrors.aliyun.com —— 这才是最终确认

已有 composer.lock 的项目切镜像必删 vendor 和 lock 文件

composer.lock 里硬编码了包的 dist URL 和哈希值，这些路径来自旧源（比如 packagist.org）。直接换镜像后，Composer 仍按原路径去阿里云找 zip 包——但阿里云的路径映射和官方不同，结果就是校验失败、下载中断、甚至 silently skip。

必须手动删除 vendor/ 目录和 composer.lock 文件
再执行 composer install，否则 update 没用，它照着旧 lock 文件里的地址请求
CI 流水线中若混用不同账号（如用 sudo 执行），配置可能写进 root 的 ~/.composer/config.json，而构建用普通用户，导致不生效

项目级配置会覆盖全局，且行为不可预测

进项目目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），不是“添加镜像”，而是全量替换 composer.json 里的 repositories 字段。哪怕你原来配了私有 Git 源，也会被一键抹掉。

如果 repositories 是数组（如 [{"type":"vcs"}]），该命令会直接覆盖整个字段
如果 repositories 是对象（如 {"my-private": {}}），则能安全 merge，但 "packagist.org": false 必须写在根节点，不能塞进某个仓库对象里
想保留私有源又用阿里云镜像？得手动编辑 composer.json，把阿里云镜像作为 "packagist" 子项写入 repositories，并确保根节点有 "packagist.org": false