replace仅在依赖解析阶段声明兼容性，不删除或替换文件；必须手动remove旧包，并配conflict防止类冲突，否则运行时会Fatal error。
replace 不是“替换命令”，它根本不会删包或换文件
Composer 的
字段只在依赖解析阶段起作用，它不执行任何安装、卸载或文件覆盖操作。你写好
，然后直接
，旧包该在还在——除非它本来就没被显式 require，或者已被其他规则排除。
必须先手动运行
，这是不可跳过的一步
是“声明我满足你的需求”，不是“请把我塞进去把别人踢出去”
如果旧包出现在
的
里，Composer 会坚持装它，
完全无效
常见错误现象：
，往往是因为旧包还挂着，新包又声明了
，形成逻辑矛盾
必须配
，否则类加载大概率炸
光有
就像给两个同名类发同一张工牌——Composer 认为“够用了”，但 PHP 加载器看到两个
定义，直接报
。
在新包的
中加：
（即覆盖所有可能版本）
查旧包实际版本用：
，再按需调整
范围
Composer 1.10+ 才完整支持
+
联动校验，老版本可能静默失败
不加
的所谓“替换”，只是把冲突从安装期推迟到运行期
下游依赖不升级，你的
在 CI 里等于没写
就算你本地删干净、
和
都配齐，只要某个已安装的包（比如
）还在
旧包，CI 或新机器上执行
就会重新拉下旧包——因为依赖图里它仍是刚需。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
查谁在依赖旧包：
，输出非空就说明有“钉子户”
这些“钉子户”包必须升级到支持新包的版本，或你自己 fork 后打 patch 修改其
中的
若它们长期不更新，你只能放弃
方案，改用
+
强制指向你的 fork（此时
只是辅助防冲突）
别信“我本地跑得通就行”，
会固化旧包路径，掩盖真实依赖关系
框架核心包别碰
，它不是给你改 Laravel/Symfony 用的
想用自定义包替代
或
？
会骗过 Composer，但骗不过自动加载器和运行时绑定。类路径、命名空间、服务提供者注册、编译期宏……全都会断。
适合：polyfill 替换、PSR 接口实现、废弃工具包继承、私有 SDK 合并子包
不适合：任何含
、
加载、服务容器绑定、事件监听器注册的框架级包
真要定制框架行为，优先用容器绑定（
）、中间件、事件监听，或打 patch（
）
看到
或
，八成是
误用于强耦合核心包
最常被忽略的一点：即使看起来旧包没了，只要里还残留它的 PSR-4 映射，或者某个已安装包的里 require 了它的引导文件，运行时就会出问题——得手动检查文件内容。
replace"replace": {"old-vendor/package": "*"}composer installcomposer remove old-vendor/packagereplacecomposer.jsonrequirereplaceYour requirements could not be resolvedreplaceconflictreplaceclass XFatal error: Cannot declare class X, because the name is already in usecomposer.json"conflict": {"old-vendor/package": "=2.5.0"}composer show old-vendor/packageconflictreplaceconflictconflictreplacereplaceconflictsome-toolrequirecomposer installcomposer depends old-vendor/packagecomposer.jsonrequirereplacerepositoriesrequirereplacecomposer.lockreplacelaravel/frameworksymfony/http-kernelreplacereplaceclassmapfiles$app->bind()cweagans/composer-patchesClass not foundTarget class does not existreplacecomposer showvendor/autoload.phpautoload-filesvendor/composer/autoload_*.php