replace 仅向 composer 声明“某包已被替代”，使其他包 require 它时跳过安装，但不触发安装、不重定向依赖、不继承 autoload；须配合移除 require 并手动配置 autoload 才生效。
replace 字段到底替换了什么
replace 不是“覆盖安装”，也不是“重定向依赖”，它只是告诉 Composer：当某个包被声明为 replace 时，其他包在 require 列表里写上被替代的包名，Composer 就会认为“那个包已经存在了”，从而跳过安装——哪怕你根本没装它。
典型误用场景：想用私有 fork 替换 monolog/monolog，却只在 replace 里写 "monolog/monolog": "*"，结果项目里依然拉下来原版，因为 replace 本身不触发安装逻辑，也不影响已声明的 require。
- 必须配合
require中移除被替代包（或确保没人 require 它），否则毫无效果 -
replace的版本约束（如"*"或"^2.0"）只用于校验兼容性，不参与版本解析 - 如果两个包同时
replace同一个包（比如 A 和 B 都声明replace: {"foo/bar": "*"}），Composer 会报错：Package foo/bar is replaced by ... and ...
什么时候该用 replace 而不是 provide 或 conflict
三者定位完全不同：provide 是“我提供了某接口能力”（比如 psr/log-implementation），conflict 是“我和谁不共存”，而 replace 是“我就是它，别再装它了”。
常见合理用例：维护一个已归档的旧包的兼容层，或者将多个小包合并为一个统一入口包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你想让
myorg/core-utils完全取代oldvendor/helpers的所有用途？用replace - 你想声明“我的包实现了 PSR-18”？用
provide，不是replace - 你想阻止用户同时装
symfony/http-foundationv5 和 v6？用conflict -
replace不会阻止别人 require 被替代包——它只影响安装决策；若需强约束，得加conflict配合
replace 导致 autoload 失效的典型原因
最常踩的坑：包 A replace 了包 B，但 A 的 autoload 没覆盖 B 的命名空间或文件路径，结果运行时报 Class not found。
Composer 不会自动继承被替代包的 autoload 配置，一切要自己配全。
- 检查被替代包的
autoload类型（psr-4、classmap、files），在当前包中完整复现 - 如果 B 用
"psr-4": {"OldVendor\": "src/"}，而 A 的类在src/下但命名空间是MyOrg\，那肯定找不到——必须改命名空间或调整映射 - 运行
composer dump-autoload -o后，用composer show -p确认 autoload 规则已生效
CI/CD 中 replace 行为不一致怎么办
本地能跑，CI 报错说 “Package X is not installed”，往往是因为 CI 环境执行了 composer install --no-dev 或缓存了旧 lock 文件，导致 replace 关系未被正确识别。
- 确保
composer.lock提交进仓库，并且生成 lock 时使用和 CI 相同的 PHP/Composer 版本 - CI 中不要用
--ignore-platform-reqs，它可能绕过replace的版本校验逻辑 - 调试时加
-v参数运行composer install，搜索日志里是否出现Replacing package oldvendor/foo - 如果依赖树深层有其他包间接 require 被替代包，
replace仍会生效，但需用composer depends oldvendor/foo找出源头并处理
replace 的实际效果高度依赖 lock 文件状态和依赖图全局一致性，单看 composer.json 很容易误判。
