Composer 中文镜像不处理虚拟包，仅代理元数据；报“virtual package not found”是因项目缺少提供该虚拟包的实际包或版本不匹配，与镜像无关。
Composer 中文镜像本身不处理虚拟包（virtual packages），它只代理 packagist.org 的元数据和 ZIP 包分发；虚拟包的解析、提供者匹配、冲突检测等逻辑完全由 Composer 本体在本地执行，镜像源无参与权限。
为什么换镜像后 composer require 报 virtual package not found？
这不是镜像的问题，而是你依赖的某个包声明了 "provide" 字段（比如 "psr/log": "^1.0"），但当前项目中没有实际安装能提供该能力的包（如 monolog/monolog）。镜像只是把原始 composer.json 文件原样同步过来，不会补全或改写 provide 声明。
- 常见错误现象：
Could not find a version of package psr/log matching your minimum-stability或Root composer.json requires psr/log ^2.0, found psr/log[1.0.0, ..., 1.1.4] but these were not loaded - 真实原因：项目里没装任何提供
psr/log的包，或者已装但版本不满足要求（例如只装了psr/logv1.x，而 require 写的是^2.0） - 镜像不影响该行为——哪怕你切回
packagist.org，报错也一模一样 - 验证方法：删掉
vendor和composer.lock，用composer install -vvv看日志里是否真从镜像地址拉取了 metadata（如GET https://mirrors.aliyun.com/composer/p/psr/log/packages.json）
composer config repo.packagist 对虚拟包有影响吗？
完全没有。这个配置只控制「从哪下载包元数据」，不改变 Composer 解析 provide、replace、conflict 的规则。只要镜像返回的 packages.json 和官方一致（事实如此），虚拟包的可见性、版本匹配、安装顺序就完全相同。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果你发现换镜像前后虚拟包行为不同，大概率是缓存未清：
composer clear-cache必须执行 - 某些旧镜像（如已停用的
packagist.phpcomposer.com）曾因同步延迟导致provide元数据滞后，但 2026 年主流镜像（阿里云、清华、华为云）均已做到 ≤5 分钟全量同步 - 注意：
repositories字段里手动加的自定义仓库（如 GitLab 私仓）如果包含虚拟包定义，才会影响结果——但这和中文镜像无关
哪些场景下中文镜像会“看起来”影响虚拟包？
本质是网络干扰掩盖了真实问题，不是镜像逻辑差异。典型情况包括：
- 镜像返回 502/404 导致 metadata 拉取失败 → Composer fallback 到空元数据 → 所有虚拟包“消失”，报
Package not found - 镜像 CDN 节点 TLS 握手异常（如中间证书过期）→ 请求被截断 → Composer 认为包不存在 → 错误归因为虚拟包缺失
- 项目级
repositories配置中误写了"packagist.org": false→ 彻底禁用 packagist 源 → 即使镜像可用，所有基于 packagist 的虚拟包也都不可见 - 镜像 URL 少了末尾
/（如https://mirrors.aliyun.com/composer）→ 请求路径拼成/composerpackages.json→ 404 → 同样 fallback 到空数据
真正关键的点在于：虚拟包是否被识别，取决于你 composer.json 里写的 require 是否有对应提供者，以及该提供者是否能被 Composer 成功加载——镜像只是通道，不是裁判。一旦看到和虚拟包相关的报错，先跑 composer diagnose 和 composer config -g repo.packagist 确认镜像生效且可连通，再回头检查 provide 声明和实际安装包的匹配关系。
