Composer 的 provide 是声明本包可替代其他包的机制，用于解决依赖冲突或兼容实现；需在 composer.json 根级 provide 字段中以 "vendor/package": "version" 格式声明，版本不可用分支别名，修改后须执行 composer update --lock 生效。
Composer provide 是什么，什么时候必须用
provide 不是安装包，而是告诉 Composer：“我这个包，能当另一个包来用”。典型场景是：你写了封装了 monolog/monolog 的日志抽象层，但不想硬依赖它，又希望别人装你包时，Composer 能认为 monolog/monolog 已存在——这时就得靠 provide。
常见错误现象：别人 require 你的包后，再 require monolog/monolog 报冲突；或者装某个依赖时提示 “monolog/monolog is required but not provided”，其实你已经提供了兼容实现。
- 只在
composer.json的provide字段里声明，不自动加载代码、不替换 autoloading - 声明格式必须是
"vendor/package": "version"，版本可以是*或约束（如^2.0），但不能写dev-main这类分支别名 - 如果你的包只是“兼容”而非“完全替代”，别乱写
provide，否则会破坏依赖解析逻辑
如何在 composer.json 中正确配置 provide
直接写进根级 JSON，不是 require 下面，也不是 autoload 里。位置错了 Composer 就忽略。
示例：一个轻量日志适配器，承诺提供 psr/log 接口实现：
{
"name": "myorg/light-logger",
"provide": {
"psr/log": "^3.0"
},
"autoload": {
"psr-4": { "MyOrg\Logger\": "src/" }
}
}
-
provide值必须是合法的版本约束，"psr/log": "*"可以，但"psr/log": "dev-main"会报错 - 多个提供项就列多个键值对，不要合并成数组或用逗号分隔
- 如果同时 require 和 provide 同一个包（比如 require
psr/log且 providepsr/log），Composer 通常接受，但可能掩盖真实依赖关系，慎用
provide 和 replace 的关键区别在哪
replace 是“我替掉你”，provide 是“我能顶替你”。实际效果差很多。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
错误做法：用 replace 声明 psr/log，结果别人装你包时，Composer 直接跳过安装 psr/log，哪怕其他依赖明确 require 它——因为 replace 会彻底移除原包的安装机会。
-
provide允许共存：psr/log可以被其他包正常 require，你的包只是“多一个可用选项” -
replace是排他性声明，常用于 fork 替换（如symfony/console被某定制版 replace），但会干扰依赖图 - 调试时看
composer show --tree，如果发现本该出现的包没出现，先查是不是被replace误杀了
为什么 provide 配置了却没生效
最常见原因：没触发依赖解析重算。Composer 不会在你改完 composer.json 后自动重新评估 provide 关系。
表现：修改了 provide，但 composer update 没反应，或者下游包仍报缺失依赖。
- 必须执行
composer update --lock或composer update vendor/name强制刷新 lock 文件里的提供关系 - 如果包已安装，
composer install不会重新检查provide，它只按 lock 文件装 - 私有包走
pathrepo 时，provide有效；但若用package方式静态定义 repo，则需手动在 repo 配置里也写provide
复杂点在于：提供关系只在安装/更新时刻参与依赖求解，运行时完全不感知。别指望它影响 autoloading 或 class_exists 判断。
