根本原因是三个硬性条件缺一不可：键名必须为单数repo.packagist、type值必须显式填composer、URL须以https://开头且末尾带/；任一缺失均静默回退至packagist.org。
composer config -g repo.packagist 命令为什么总不生效
根本原因不是网络问题，而是三个硬性条件缺一不可：repo.packagist 这个 key 不能多写 s（比如 repos.packagist），composer 这个 type 必须显式写出，URL 必须是 HTTPS 且末尾带 /。
常见失败组合：
-
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺composertype，静默 fallback 到官方源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 少斜杠，请求变成/composerpackages.json，404 不报错但卡住 -
composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/→ HTTP 被 Composer 2.2+ 默认拒绝
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。Windows 用户改完要重启终端，否则 PHP 进程读不到新配置。
全局镜像 vs 项目级镜像，哪个更可靠
生产环境必须用 composer config -g 全局设置。CI 构建、Docker 镜像、root 用户部署脚本，都依赖这个全局配置生效；临时加 --repository 或改单个项目 composer.json 的 repositories，容易被缓存覆盖、漏配或仅在交互式终端起作用。
项目级配置只适用于开发机单项目调试，且需注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repositories数组里加多个镜像 ≠ fallback —— 它只影响非 packagist 类型源，元数据请求仍直连packagist.org - 项目级配置不会覆盖全局
repo.packagist，两者共存时以全局为准 - 提交
composer.json时，repositories字段会被其他协作者或 CI 环境忽略，除非他们也手动设了全局镜像
镜像源切换后为什么还卡在Downloading
现象是命令卡在 Downloading https://packagist.org/packages.json 或某个 ZIP 地址，说明镜像根本没走通——不是下载慢，而是配置未命中。
排查步骤：
- 运行
composer diagnose，确认输出中同时出现secure-http: OK和signature verification: OK；若提示signature verification: disabled，说明镜像跳过了签名校验，有安全风险 - 执行
composer config -g repo.packagist，输出不是预期 JSON，就立刻重设（别信 CI 日志里“已配置”的记录） - 删掉
vendor/和composer.lock，再跑composer install --no-dev --no-scripts --no-autoloader；composer.lock是宕机时唯一保命文件，它不存在或不完整，换镜像也没用
阿里云、Laravel China、腾讯云镜像怎么选
三者同步延迟和稳定性差异不大，但细节影响实操：
- 阿里云镜像（
https://mirrors.aliyun.com/composer/）支持 signature 验证，配合composer config -g security.signature true可兼顾速度与安全 - Laravel China 镜像（
https://packagist.laravel-china.org）响应快，但部分旧版本包可能缺失，适合快速试错场景 - 腾讯云镜像（
https://mirrors.cloud.tencent.com/composer/）在华南机房内网访问更快，但需确认其是否启用 TLS 1.3 支持（某些老版 OpenSSL 会握手失败）
真正决定稳定性的，从来不是镜像本身的速度，而是 composer.lock 是否存在、签名验证是否开启、缓存是否干净——镜像只是把“能拉下来”这件事从概率事件变成确定事件。
