必须手动删除composer.lock和vendor后执行composer install，因replace仅作用于依赖解析阶段，不更新已锁死的旧包；同时需确保新包replace版本范围匹配旧包实际使用版本，并排查间接依赖。
旧包名还在 composer.lock 里，但新包已发布，怎么办？
Composer 不会自动把旧包名替换成新包名，哪怕你在新包的 composer.json 里写了 "replace"。它只在安装/更新时起作用，对已锁死的依赖无感。所以你执行 composer install，旧包依然被加载；执行 composer update，旧包可能仍被保留——除非明确告诉 Composer “别再装它了”。
-
replace字段本身不触发卸载，它只是声明“我替代了谁”，供其他包在依赖解析时参考 - 真正生效的前提是：旧包未被任何其他依赖显式要求，且你运行了
composer update（而非install） - 如果旧包出现在
require或require-dev中，必须手动删掉那一行，否则 Composer 会坚持装它
replace 字段写法不对，导致迁移失败
常见错误是把 replace 当成重定向开关，随便填个旧包名就以为万事大吉。实际上，Composer 要求版本号也得匹配——不是“只要名字对就行”，而是“你声明替代的版本范围，必须覆盖旧包当前被使用的版本”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误写法：
"replace": {"oldvendor/oldpackage": "*"}——*不被replace支持，会直接忽略该条目 - 正确写法：
"replace": {"oldvendor/oldpackage": "^1.0 || ^2.0"}，或更稳妥地写成"oldvendor/oldpackage": "self.version"（如果你的新包版本号与旧包兼容） - 若旧包最新版是
2.3.1，而你的新包composer.json中version是3.0.0，那"oldvendor/oldpackage": "3.0.0"就不匹配，Composer 不会把它当替代项处理
执行 composer update 后旧包还在 vendor/ 里
这通常不是 replace 失效，而是旧包仍被间接依赖。Composer 的依赖解析是全局的，只要某个已安装的包在它的 composer.json 中写了 "require": {"oldvendor/oldpackage": "^2.0"}，Composer 就会继续保留它。
- 运行
composer depends oldvendor/oldpackage查看谁在依赖它 - 若输出为空，说明没人显式依赖，但旧包仍在
vendor/，大概率是composer.lock没刷新——删掉composer.lock和vendor/，再跑composer install - 若输出指向第三方包（比如
some/legacy-tool），那你得等它升级，或 fork 后 patch 它的composer.json，把对旧包的 require 改成对新包的 require
为什么 replace 不能解决所有迁移问题？
因为 replace 只影响依赖图构建阶段，不处理运行时兼容性。比如旧包里有个类叫 OldVendor\OldPackage\Foo，新包改成了 NewVendor\NewPackage\Foo，即使 replace 让 Composer 不再装旧包，代码里 use OldVendor\OldPackage\Foo 还是会报错。
- 真正的无缝迁移需要配合
autoload的psr-4映射 + 类重命名 +classmap兼容层，甚至alias（PHP 8.2+） -
replace是必要但不充分条件；它帮你绕过安装冲突，但搬不走代码里的引用 - 最容易被忽略的是：某些 CI/CD 流程会缓存
vendor/，导致本地测试正常，线上却始终加载旧包——检查是否用了--no-scripts或跳过了composer install --no-interaction
