Composer虚拟包是仅通过provide字段声明契约而不含代码的伪包，用于在依赖解析中表明“某接口已被实现”，需满足包名合法、版本约束有效且不列入require；它与真实接口包配合实现运行时解耦。
什么是 Composer 虚拟包（virtual package）
虚拟包不是真实存在的代码包，而是一个仅在 composer.json 中声明的、不带源码的包名，它只靠 provide 字段向依赖解析器“声称自己实现了某个接口或能力”。它的作用不是提供功能，而是参与依赖图的逻辑推导——让 Composer 知道“某项契约已被满足”，从而绕过对具体实现的硬依赖。
provide 字段怎么写才有效
必须满足三个条件，Composer 才会把它当真：
-
provide的键必须是合法的包名格式（如mycompany/logging-interface），不能带空格或特殊符号 - 值必须是语义化版本约束（如
"^1.0"），不能写"*"或留空 - 该虚拟包不能同时出现在
require列表里——否则 Composer 会报错“package not found”，因为它压根没地方下载
典型用法是在一个 SDK 包里声明它提供了某个抽象契约：
{
"name": "mycompany/alipay-sdk",
"provide": {
"mycompany/payment-interface": "^1.0"
},
"require": {
"php": ">=8.1",
"ext-curl": "*"
}
}
为什么不用 replace 或 conflict
replace 是用来“顶替”另一个包的安装行为（比如用 laravel/framework 替换 illuminate/*），它会阻止被替换包被加载；conflict 是做排除，两者都不解决“契约已实现”这个语义。只有 provide 能让 Composer 在 SAT 求解过程中把“接口已满足”当作一个真命题参与推理——这才是解耦的关键支点。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误是把 provide 和 require 写反：比如订单模块本该 require "mycompany/payment-interface": "^1.0"，结果误写成 provide，导致依赖图断裂，Composer 报 your-vendor/order-module requires mycompany/payment-interface ^1.0 -> found mycompany/payment-interface[dev-main] but the package is virtual 这类看似矛盾的提示。
虚拟包 + 接口包 = 真正的运行时解耦
光有虚拟包不够，你还得有一个纯接口包（比如 mycompany/payment-interface），里面只有 PaymentGatewayInterface 这类定义，不带任何实现、不 require 任何 SDK。它的 composer.json 甚至可以空着 require，只保留 autoload 声明 PSR-4。
这样组合起来，业务模块（如订单）只依赖接口包，支付 SDK 包通过 provide 声明契约，主项目同时 require 两者——Composer 就能确认“接口有实现”，但运行时完全不感知是微信还是支付宝在干活。一旦要切支付渠道，只需换掉 require 的 SDK 包，连订单模块的代码和测试都不用动。
最容易被忽略的一点：虚拟包无法提供自动加载逻辑，所以 provide 的包名必须对应一个真实存在的接口包（哪怕只是空壳），否则 IDE 和静态分析工具会丢失类型提示，new 实例化时也会报错——provide 解的是依赖图，不是自动加载路径。
