虚拟包是仅作依赖约束的逻辑占位符，无实际代码；实包含真实文件并提供功能。虚拟包通过provide声明能力，实包通过Provides字段实现该能力，二者协同完成语义化依赖管理。
什么是虚拟包，它和普通包有什么区别
虚拟包不是真实存在的包，而是一个仅在 composer.json 中声明、不对应任何实际代码仓库的占位符。它不能被 require 安装，也不能被 composer install 下载，但可以被其他包当作依赖来约束或替换——这正是封装内部基础库的关键：用它统一约束多个私有组件对底层能力的版本要求。
比如你有一套内部日志规范、统一异常处理、通用 HTTP 客户端，它们各自是独立的私有 Git 包（corp/logger、corp/exception、corp/http-client），但都必须“兼容 v2.0 的内部契约”。这时你不该让每个包都硬写 "php": ">=8.1" 这类泛化约束，而应定义一个虚拟包 corp/base-contract，把契约版本显式拎出来。
怎么声明一个虚拟包
虚拟包本身不需要源码，也不上传到 Packagist 或私仓。它只存在于主项目的 composer.json 的 replace 或 provide 字段中。常用做法是用 provide 声明当前项目“提供了”某个抽象能力：
-
"provide": { "corp/base-contract": "2.0.0" }—— 表示本项目（比如一个内部框架）实现了corp/base-contractv2.0.0 的契约 -
"replace": { "old-legacy-lib": "*" }—— 用于彻底替代一个已废弃的旧包（慎用，会阻止安装）
注意：provide 不会触发下载，也不会出现在 vendor/ 里；它只参与依赖解析时的版本匹配。其他包只要在自己的 require 中写 "corp/base-contract": "^2.0"，Composer 就能识别出当前项目已满足该约束。
为什么不用子模块或 symlink，而选虚拟包
本地开发时有人倾向用 path 仓库 + symlink 管理内部库，但这在 CI/CD 或多环境部署时极易出错：symlink 权限问题、路径不一致、Git 忽略导致 vendor 为空。虚拟包绕开了文件级耦合，只做语义约束。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见踩坑点：
- 把虚拟包名写成
corp/base-contract却没在任何真实包里实现它 → Composer 解析失败，报错Root package 'xxx' cannot satisfy constraint 'corp/base-contract': it is not present in the repository. - 在私有 Git 包里错误地用了
replace而非provide→ 导致依赖该虚拟包的其他包被跳过安装 - 虚拟包版本号没对齐：A 包 require
"corp/base-contract": "^2.0"，但主项目只provide了"2.1.0"，而 B 包又 require"^2.2"→ 解析冲突，报 SAT 求解失败
如何配合私有仓库使用虚拟包
虚拟包必须和真实包协同才有意义。典型流程是：
- 先在私有 Git 仓库发布一个真实的基础包（如
corp/base-sdk），它包含接口定义、抽象类、常量等契约内容 - 在主项目
composer.json中通过repositories添加该私仓，并require它 - 同时在主项目中
provide一个虚拟包（如corp/base-contract），版本号与corp/base-sdk主版本对齐 - 其他业务包（如
corp/order-service）只require "corp/base-contract": "^2.0"，不直接依赖corp/base-sdk—— 解耦更干净
这种结构下，升级基础契约只需改主项目的 provide 版本 + 更新 corp/base-sdk，所有业务包自动继承约束，无需逐个修改 composer.json。
最易被忽略的是：虚拟包没有自动加载逻辑，它不提供任何类。所有具体实现仍需由真实包（如 corp/base-sdk）通过 autoload 配置暴露。别指望只靠 provide 就能让 new BaseException() 工作起来。
