Composer全局镜像唯一生效配置是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须严格包含-g、正确键名、composer类型及末尾斜杠URL，缺一静默失效。
全局镜像配置只用一条命令，其他操作基本是白忙活。 Composer 的镜像加速不是“配了就快”，而是“配对了才快”——错一个字段、少一个 -g、被项目级配置覆盖，都会让请求继续打向国外源。
为什么 composer config -g repo.packagist 是唯一可靠入口
Composer 2.9.6（当前稳定版）读取全局配置只认 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）。手动编辑这个文件极易出错：file_get_contents(): Failed to open stream 是最常见的报错，根源往往是 JSON 逗号遗漏、末尾多加斜杠、缩进混用空格与 Tab。
composer config -g 会自动：校验 JSON 合法性、安全写入、保留已有字段（比如 auth.json 中的 token）、适配不同系统路径。它不依赖你记住文件位置，也不吃你手写的格式。
- 错误示范：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/→ 没加-g，写进当前项目composer.json的repositories字段，对其他项目无效 - 危险操作：
sudo composer config -g ...（Ubuntu 下）→ 配置落到/root/.composer/config.json，普通用户运行时根本读不到 - 字段写错：
repos.packagist或repositories.packagist.org→ Composer 完全忽略，静默失败
验证镜像是否真正在生效，别只信 composer config -g 输出
composer config -g repo.packagist 只告诉你“你写了什么”，不是“它在用什么”。真正判断依据是网络请求行为。
执行这条命令观察真实 HTTP 请求：
composer clear-cache && composer require monolog/monolog -vvv
在输出日志里搜索 Downloading，确认出现的是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Downloading https://mirrors.aliyun.com/composer/packages.json✅ - 而不是
https://packagist.org/packages.json或https://repo.packagist.org/packages.json❌
如果看到后者，说明项目级 composer.json 中的 "repositories" 字段覆盖了全局设置——此时要删掉或注释掉项目里的该字段，或改用 "packagist": false 显式禁用默认源。
Ubuntu Server 上推荐的镜像源与性能差异
阿里云镜像（https://mirrors.aliyun.com/composer/）和 Laravel China 镜像（https://packagist.laravel-china.org）目前都稳定可用，但实际表现有差异：
- 阿里云镜像响应更快，尤其在华南、华东节点；支持 HTTPS + HTTP/2，Composer 2.9.6 的并行下载能更好发挥其带宽优势
- Laravel China 镜像对 Laravel 相关包做了预热缓存，首次拉取
laravel/framework类包可能略快，但通用包不如阿里云均衡 - 已停用的
https://packagist.phpcomposer.com不再维护，强制使用会导致 404 或降级到官方源
如果你的服务器在阿里云 ECS 上，优先用阿里云镜像；如果是教育网或北方联通线路，可试 Laravel China 镜像，但务必用 -vvv 实测验证。
容易被忽略的兼容性陷阱
Composer 2.9.6 默认启用 https 协议和 TLS 1.2+，但某些老旧 Ubuntu Server（如 16.04）的 OpenSSL 版本过低，会导致连接镜像站失败，报错类似 cURL error 35: SSL connect error。
这时不要降级 Composer，而应升级系统底层：
- Ubuntu 16.04：运行
sudo apt update && sudo apt install openssl libssl1.0-dev（注意不是libssl-dev） - Ubuntu 18.04+：确保
ca-certificates包已更新：sudo apt update && sudo apt install --reinstall ca-certificates
配置完别忘了清缓存：composer clear-cache，否则旧的失败记录可能干扰后续请求。
