replace仅声明兼容性，不删除旧包；若未手动remove旧包、未配conflict阻断类冲突、下游依赖仍require旧包，则vendor中两包共存，php加载时因类重定义报fatal error。
replace字段为什么会导致“安装成功但运行报错”
因为replace只是告诉 Composer “我提供同名功能”，不删旧包、不改自动加载、不阻止类定义重复。你配了"replace": {"old-vendor/package": "*"}，但没手动删掉old-vendor/package，它俩的类文件就共存于vendor/里——PHP 加载器一碰到两个class X，立刻抛Fatal error: Cannot declare class X。
常见错误现象：
-
composer install 无报错，
vendor/里却同时存在新旧两个包 - 本地跑通，CI 失败，日志里出现类重定义错误
- 执行
composer show old-vendor/package仍有输出，说明它还在
必须执行的三步操作顺序不能乱
replace 不是命令，是声明；生效的前提是旧包物理消失 + 冲突显式阻断 + 依赖图干净。漏任何一步都会埋雷。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先手动运行
composer remove old-vendor/package（不是require --dev或注释，必须删） - 在新包的
composer.json中加"conflict": {"old-vendor/package": "*"}（用*覆盖所有版本，别写=2.5.0这种漏网版本） - 检查项目里有没有其他已安装包仍
require旧包：运行composer depends old-vendor/package，输出非空就得升级或 fork 那些包
哪些场景千万别用replace
它不是通用替换工具，而是为特定迁移场景设计的窄口径机制。强行滥用只会让依赖关系更不可控。
- 想替代
laravel/framework或symfony/http-kernel？不行。框架核心的绑定、服务注册、编译宏全会断，replace骗得过 Composer，骗不过运行时 - 两个包都提供
psr/log接口但实现不兼容？别用replace，该用conflict明确互斥 - 只是为了“减少 vendor 体积”而替换一个只被 dev 工具用的包？大概率引发
require-dev冲突，得不偿失
验证是否真清理干净的三个命令
别信“我删过了”，得用命令确认。尤其 CI 环境下，缓存和残留包极易复活。
-
composer show old-vendor/package—— 输出应为Package not found -
composer depends --tree old-vendor/package—— 输出应为空（说明没人再拉它） -
find vendor/ -name "*old-vendor*" -type d—— Linux/macOS 下直接扫目录，Windows 可用dir /s vendor\*old-vendor*
只要其中任一命令有非空输出，说明旧包还在某个角落活着，运行时出错只是时间问题。
