Composer无法安全共存同一包的两个版本，因PHP自动加载机制全局唯一，类名和命名空间冲突必然导致Cannot redeclare class等致命错误。
Composer 不支持、也不能安全地同时安装同一包的两个版本。这不是限制，而是 PHP 语言层和自动加载机制共同决定的硬边界——类名冲突、命名空间重复、class_exists 失效、Cannot redeclare class 报错，都是必然结果。
为什么 PHP 层面就不可能共存？
PHP 的 autoload 是全局注册的，所有 require 或 include 都走同一套映射。一旦 monolog/monolog v2 和 v3 同时被载入，它们的 Monolog\Logger 类就会在同一个命名空间下被定义两次，PHP 直接中止执行。
Composer 的 autoload.php 是单入口、扁平化生成的，它不会、也无法为同一名字空间下的不同版本做隔离或重映射。
- 不是 Composer “没做这个功能”，而是它根本绕不开 PHP 的运行时约束
-
replace、provide等字段只能骗过依赖解析器，不能改变实际类加载行为 - 哪怕你手动改
vendor/autoload.php加条件判断，也会在composer dump-autoload时被覆盖
常见误操作与对应后果
开发者常试图用这些方式“绕过”限制，但每种都会引发明确且难调试的问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json中对同一包写两条require（如"monolog/monolog": "^2.0"和"monolog/monolog": "^3.0"）→ Composer 直接报错：Package monolog/monolog is already required in another version - 用
pathrepository 引入本地修改版，又保留原包 → 安装成功但运行时报Class 'Monolog\Handler\StreamHandler' not found（因 autoload 只认其中一个路径） - 把两个 vendor 子目录分别
require进来 → 出现Cannot declare class XXX, because the name is already in use，顺序依赖导致行为不可控
真需要多版本时，该怎么做？
必须跳出“全项目统一加载”的思维。可行路径只有两条，且都要求主动隔离：
- 用子进程调用：把依赖旧版的逻辑封装成独立 CLI 工具（如
php bin/legacy-logger.php），主项目通过proc_open或shell_exec调用，完全隔开 PHP 进程和 autoload 环境 - 用 classmap + 手动重映射：删掉该包的 PSR-4 声明，改用
"classmap": ["vendor/monolog/monolog/src/"]，再自己写spl_autoload_register按前缀路由到不同路径 —— 但从此composer dump-autoload对它失效，维护成本陡增
绝大多数所谓“必须多版本”的场景，其实只是某个插件或 SDK 尚未升级。与其硬扛，不如推动上游兼容，或临时 fork 并 patch 兼容层。
真正棘手的从来不是怎么“装上”，而是怎么让两个版本的类不互相看见——而 Composer 的设计前提，就是假设你不需要这么做。
