虚拟包是抽象接口契约（如psr/log），不对应真实安装包；provide字段仅向Composer声明“本包已实现该契约”，不安装任何内容，也不保证运行时正确性。
Composer 的 provide 字段不能真正“安装”虚拟包，它只是向依赖解析器声明：“本包已具备某虚拟包所定义的能力”。如果下游包通过 require 声明依赖该虚拟包，而你又没提供真实实现或未正确配置，安装会失败或运行时报错。
什么是虚拟包，为什么需要 provide
虚拟包（如 psr/log、php-http/async-client-implementation）不对应真实可安装的包，而是抽象接口契约。它们用于解耦：一个日志库只需声明自己 provide 了 psr/log，消费者就能通过 require "psr/log" 来写类型提示和依赖注入，而不绑定具体实现。
- Composer 不会下载或安装虚拟包本身，只靠
provide告诉它“这个能力已被满足” - 若多个包都
provide同一虚拟包（如两个 HTTP 客户端都声明提供php-http/client-implementation），Composer 会报错Conclusion: don't install ... (conflict)，除非你用replace或显式选一个 -
provide必须写在composer.json的根级require或require-dev之外，直接作为顶层字段
provide 字段的正确写法与常见错误
provide 是一个对象，键是虚拟包名，值是版本约束（通常用 * 表示兼容任意版本）。它不是用来“替代”真实包的，也不影响自动加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- ✅ 正确：
"provide": { "psr/log": "*", "myorg/cache-adapter": "1.0" } - ❌ 错误：把
provide写进require里 —— Composer 会当成真实依赖去查找包，找不到就报could not find package - ❌ 错误：提供带 dev-master 或分支名的版本（如
"*@dev"）—— 虚拟包无实际版本历史，应统一用*或语义化版本范围（如">=1.0 ） - ⚠️ 注意：
provide不会自动添加 autoloading；你要自己确保接口类（如Psr\Log\LoggerInterface）能被加载，否则运行时 fatal error
当 require 虚拟包却无法安装时怎么排查
典型报错：Your requirements could not be resolved to an installable set of packages. + 提到某个虚拟包未被满足。
- 运行
composer show --platform查看当前环境中哪些虚拟包已被平台或已装包提供（如 PHP 扩展提供的ext-curl） - 运行
composer depends <virtual-package-name>（如composer depends psr/log）确认谁在 require 它，以及是否已有提供者 - 检查是否漏写了
provide，或拼写错误（psr/log≠psr/log-interface） - 如果你是库作者，别只在
require-dev里写provide—— 开发时看着正常，但下游项目安装时不会读取require-dev中的provide
provide 和 replace、conflict 的关键区别
三者都出现在 composer.json 顶层，但作用完全不同：
-
provide：声明“我实现了这个契约”，不阻止其他包也提供同一契约（除非冲突规则介入） -
replace：声明“我完全替代某个真实包”，比如 Laravel 的illuminate/support替代symfony/translation某些功能，会阻止后者被安装 -
conflict：声明“我不能和某个包共存”，比如某旧版组件与 PHP 8.2 不兼容，就写"conflict": {"php": ">=8.2.0"} - ⚠️ 特别注意：
provide不会触发conflict自动检查 —— 如果你提供了psr/log，但同时又conflict了psr/log的某个版本，Composer 不会警告，但逻辑上矛盾
最易被忽略的一点：provide 只在依赖解析阶段起作用，它不修改自动加载、不注册服务、不执行任何代码。契约是否真被满足，最终取决于你的类是否可实例化、方法签名是否匹配、运行时是否抛出 TypeError —— Composer 管不了这些。
