provide 不能替换当前包，仅声明本包实现的能力；真正替换需用 replace，且必须与 provide 配合：replace 删除原包，provide 证明接口兼容性。
想用别的包“替换”当前包，provide 本身做不到——它只负责声明“我能当谁用”，不阻止原包安装，也不改变依赖决策流向。真要替换，得靠 replace；而 provide 是让替换后还能被其他依赖正确识别的关键配角。
provide 字段根本不是用来“替换当前包”的
provide 的作用对象是“别人 require 的东西”，不是你自己的包。它写在你这个包的 composer.json 里，告诉 Composer：“我实现了 psr/log-implementation 这个能力”，而不是“请把我替换成 monolog/monolog”。如果你在根项目里加 "provide": {"my-old-package": "*"}，完全无效——Composer 只读已安装包的 provide，不看你本地项目声明了什么。
常见误操作：
- 把
provide写进require对象里，比如"require": { "provide": { "psr/log": "^3.0" } }→ 被彻底忽略 - 在根
composer.json中写provide想“声明自己提供某个能力” → 不参与依赖解析，白写 - 以为写了
"provide": {"monolog/monolog": "2.10.0"}就能替代 monolog → 实际上 monolog 还会照常装，甚至引发冲突
真正替换包，必须用 replace 字段
replace 才是干“替换”这事的。它告诉 Composer：“别装 monolog/monolog 了，我这个包已经包含全部功能”。但注意：replace 单独用风险极高——它只是删掉原包，不保证你真实现了它的接口。
安全替换的硬性条件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
replace必须和provide配合使用：前者删包，后者证明你有契约兼容性 -
replace的包名必须严格匹配（大小写、vendor/name 全对），否则 Composer 会静默跳过 - 版本号不能写
dev-main或3.x，只能是合法约束，如"*"、"^2.0"、">=2.0.0" - 如果多个包都
replace同一个名字（比如两个 fork 都 replaceguzzlehttp/guzzle），Composer 直接报 conflict，必须手动干预
provide + replace 组合怎么写才生效
假设你开发了一个轻量日志组件 acme/simple-logger，想完全替代 monolog/monolog，同时让框架能通过 psr/log 接口正常调用：
✅ 正确写法（放在 acme/simple-logger 自己的 composer.json 中）：
{
"name": "acme/simple-logger",
"replace": {
"monolog/monolog": "*"
},
"provide": {
"psr/log": "^3.0",
"psr/log-implementation": "*"
}
}
⚠️ 关键点：
-
replace和provide必须同级，都在根层级 -
provide中写"psr/log": "^3.0"，不是"psr/log-implementation": "^3.0"—— 后者是虚拟包名，前者是真实标准包，影响类加载兼容性 - 改完必须运行
composer update --lock，否则 lock 文件不更新，CI/线上仍按旧图解析 - 如果你没实现
Psr\Log\LoggerInterface全部方法，就别写"psr/log": "^3.0"，否则下游运行时调用缺失方法直接 fatal error
调试时怎么确认 provide 是否起作用
光看 composer install 成功不代表 provide 生效了。验证方式很直接：
- 运行
composer show --tree，找目标包是否出现在依赖树中；如果该包本该出现却消失，优先查是不是被replace误杀 - 运行
composer depends psr/log-implementation（或你声明的虚拟包名），看是否列出你的包 - 在项目里执行
composer why psr/log，确认 Composer 认为你这个包满足了psr/log依赖 - 如果某依赖报错
Root composer.json requires monolog/monolog, but none of the packages provide it，说明provide没被识别——先检查包名拼写、大小写、是否写在正确位置
最常被忽略的是：你写的 provide 确实生效了，但运行时 autoload 没配好，类根本加载不了——provide 不解决 autoload，它只管依赖图。
