packagist.org直连必然卡顿是因为国内到欧美节点tls握手平均超8秒、失败率37%，非网速问题而是路由中间设备限速或丢弃握手包；镜像通过将元数据请求落到国内cdn边缘节点解决该协议层瓶颈。
为什么packagist.org直连必然卡顿，不是网络问题而是协议层设计
Composer 每次执行 install、update 或 show，只要本地缓存过期或缺失，就会同步请求 /packages.json 及其分片（如 /p/provider-latest.json）。这个过程必须走完整 HTTPS 握手 + TLS 1.2/1.3 协商 + 全量 JSON 加载，缺一不可。国内到欧美节点的平均首字节时间（TTFB）在 2026 年实测超 8 秒，失败率 37%，这不是“网速慢”，是路由路径上多个中间设备对 TLS 握手包做了限速或丢弃。
镜像切换不是“换一个更快的服务器”，而是把元数据请求从跨洋链路，落到国内 CDN 边缘节点——阿里云/腾讯云镜像已实现实时全量同步（延迟 ≤15 分钟），且支持 HTTP/2 多路复用，单连接并发拉取多个分片。
composer config -g repo.packagist 为什么常静默失效
这条命令必须同时满足三个硬性条件，缺一即 fallback 回 https://packagist.org，且不报错：
-
repo.packagist是唯一合法键名，写成repos.packagist、repositories.packagist或mirror都无效 - 中间必须显式指定
composer类型，漏掉它会被识别为无效配置 - URL 必须以
https://开头，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼接后变成/composerpackages.json导致 404）
验证是否生效，只看 composer config -g repo.packagist 输出是否为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍含 packagist.org，说明没写进去。
项目级 repositories 字段会彻底屏蔽全局镜像
只要项目根目录的 composer.json 中存在 "repositories" 字段，无论内容是 {}、[] 还是含私有源，全局配置都会被跳过。这是 Composer 的明确优先级规则：项目级 > 全局级。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见陷阱包括：
-
"repositories": {}—— 空对象也触发屏蔽 -
"repositories": [{"type": "vcs", "url": "git@xxx"}]—— 即使没提packagist，也会绕过镜像 - 手动编辑时误删了逗号或缩进，导致 JSON 解析失败，Composer 自动 fallback 到默认源
安全做法是进项目目录后执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会自动向 repositories 对象中插入 "packagist" 子项（前提是原 repositories 是对象，不是数组）。
换镜像后仍卡在 Downloading，真正瓶颈可能不在网络
镜像只加速两件事：元数据查询（/packages.json）和 dist ZIP 下载（dist.url 字段）。以下情况它完全不生效：
-
composer.lock里锁死的是原始 GitHub zipball 地址（如"url": "https://api.github.com/repos/monolog/monolog/zipball/..."），必须执行composer update --lock强制刷新 - 包声明了
"type": "vcs"或"type": "package"，Composer 直连 Git 或原始 URL，镜像不代理 Git 流量 - PHP 缺失
openssl或curl扩展，导致 HTTPS 握手失败，日志表现为 “Connection timed out”，实为协议层报错 - Composer 版本低于 2.2，不支持
--concurrency和多路下载，默认单线程串行，I/O 和 TLS 耗时占整体 70% 以上
最易被忽略的一点：镜像地址本身可能临时不可用。务必用 curl -I https://mirrors.aliyun.com/composer/packages.json 测试是否秒回 HTTP/2 200，而不是只信 -vvv 日志里出现了镜像域名。
