replace 字段仅在被安装的库包自身 composer.json 中生效，主项目中声明无效；真正替代需闭环五步：remove 原包、配置 repositories、require 时用 as 别名、fork 包内写 conflict 排除原包、并正确声明 provide。
replace 字段只在库包 composer.json 里生效
你在项目根目录的 composer.json 里写 "replace": {"monolog/monolog": "*"}，Composer 完全无视。它只认被安装的**库包自身声明的 replace**——也就是说，必须是你 fork 或重写的那个包（比如 myorg/monolog-bridge），在其自己的 composer.json 中明确写了 "replace": {"monolog/monolog": "^2.0"}，才可能参与依赖解析。
常见误操作：
- 直接在主项目里加
replace，幻想“跳过安装”，结果composer install照装原包 - fork 后没改自己包的
composer.json，只配了repositories和require，导致 Composer 认为“两个包并存”，而非“一个替代另一个” - 用
replace替代provide声明接口能力，比如想让自定义日志器满足psr/log-implementation，却只写replace不写provide，运行时类加载失败
真正起效必须手动 remove + repositories + require + as + conflict
replace 不是开关，而是依赖求解器的一条“逻辑规则”。它不卸载、不覆盖、不自动拉取——所有动作都得你亲手闭环。
缺一不可的五步：
- 先运行
composer remove monolog/monolog：已安装的包不会被replace清掉，这步跳过，vendor 里永远留着冲突源 - 在根
composer.json的repositories中添加 vcs 源：{"type": "vcs", "url": "https://github.com/myorg/monolog-bridge"} -
require写原包名 + 分支别名："monolog/monolog": "dev-main as 2.9.0"，其中as后的版本必须满足其他依赖的约束（如symfony/console要求^2.8，你就不能 alias 成1.0.0） - 在你 fork 的包（
myorg/monolog-bridge）自己的composer.json中加"conflict": {"monolog/monolog": "*"}，强制排除原包；老版本 Composer（ - 手动抄全原包的
autoload规则（用composer show -p monolog/monolog查），否则Class not found
replace 无法解决运行时类/函数/配置文件冲突
replace 只影响依赖解析阶段是否安装某个包，它不重命名文件、不修改类名、不合并配置、不拦截全局函数声明。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型失效场景：
- 两个包都定义了同名全局函数
helper_do_something()：Composer 不管这个，PHP 启动就报Fatal error: Cannot redeclare helper_do_something() - Laravel 项目中多个包都发布
config/logging.php：文件会覆盖或报错，replace对此无能为力，得靠extra.laravel.dont-discover或手动php artisan vendor:publish - 你 fork 的包没改命名空间，仍用
Monolog\Logger，而原包也用这个命名空间：PSR-4 加载器会随机加载其中一个，行为不可控
想覆盖某几个文件？别碰 replace，用 patch 插件或构建脚本 cp 替换。
验证是否真生效：看 depends，不是看 show
composer show monolog/monolog 还能查到结果？说明根本没被替代。真正的生效信号是：
-
composer depends monolog/monolog返回no packages require monolog/monolog -
composer show -p myorg/monolog-bridge输出里包含完整的 autoload 映射，且路径与原包一致 - 运行时调用
new \Monolog\Logger(...)不报错，且实际加载的是你 fork 包里的类（可用debug_print_backtrace()或 xdebug 验证）
最容易被忽略的硬性前提：你 fork 的包，必须真实提供原包的所有公共 API 行为。否则即使 Composer “认为”它替换了，运行期也会因方法不存在或签名不匹配而崩。
