Composer无法同时安装同一包的多版本，因PHP自动加载器无版本隔离能力，依赖图必须为单向无环图，求解器仅输出唯一满足全部约束的版本快照；可行替代方案包括接口抽象+适配器封装、运行时手动加载、进程/服务拆分或重命名发布私有包。
Composer 无法在一个项目中同时安装同一包的两个不同版本。这不是配置问题，而是设计限制：PHP 的自动加载器没有命名空间或版本隔离能力，依赖图必须是单向无环图（DAG），Composer 的求解器只能输出一个满足全部约束的版本快照。
为什么 composer require "foo/bar:^1.0" 和 "foo/bar:^2.0" 会报错
错误信息类似：Root composer.json requires foo/bar ^1.0 and foo/bar ^2.0 -> satisfiable by foo/bar[1.x] and foo/bar[2.x]。这不是 Composer “没配对”，而是它明确拒绝构造出逻辑矛盾的依赖树——同一个类名（如 Foo\Bar\Client）不能由两个不同版本的 foo/bar 同时提供，否则运行时必然冲突。
- 即使你手动改
composer.json写两行"foo/bar": "^1.0"和"foo/bar": "^2.0"，composer update也会直接失败 -
composer.lock中每个包只出现一次，且记录的是最终解析出的唯一版本和 commit hash - 试图用
pathrepo 或packagetype 声明“重命名版”包（如foo/bar-v1）能绕过语法检查，但无法解决自动加载冲突——除非你彻底重写其命名空间并隔离 autoloader
真正可行的替代方案有哪些
不是“怎么配”，而是“怎么换思路”。常见场景其实是：旧代码依赖 v1 的 API，新模块想用 v2，但又不能立刻全量升级。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
接口抽象 + 适配器封装：定义统一接口（如
HttpClientInterface），为 v1 和 v2 分别写V1Adapter、V2Adapter，运行时按需注入。不引入额外包版本，只增加业务代码 -
运行时手动加载（慎用）：把其中一个版本用
require_once加载进独立作用域（如闭包内），避免注册到全局 autoloader；但无法使用其依赖的其他包，且难以测试和维护 -
拆分进程或服务：将依赖 v2 的功能抽成独立 CLI 命令或 HTTP 微服务，主项目通过
proc_open()或 Guzzle 调用，物理隔离版本 -
重命名发布（仅限可控包）：若你控制该包源码，可 fork 后修改
composer.json的name字段（如从foo/bar改为foo/bar-legacy）和所有命名空间，再作为私有包发布。这是唯一能让 Composer “认作不同包”的方式
哪些“看起来像多版本”的做法其实无效
这些操作常被误认为能解决问题，但实际要么失效，要么埋下更大隐患：
-
"config": { "platform": { "foo/bar": "1.5.0" } }——platform只模拟 PHP 版本或扩展，**不支持模拟任意包版本**，此配置会被 Composer 忽略 - 在
repositories里加两个package类型条目，分别指向 v1 和 v2 的 dist —— Composer 仍会因名称重复而报错，或静默覆盖掉一个 - 先
composer require foo/bar:^1.0，再composer require foo/bar:^2.0 --no-update，最后composer update—— 第二个require会直接覆盖第一个，--no-update不改变composer.json中的键值对唯一性 - 手动修改
vendor/下的文件或 symlink —— 下次composer install或update会被清空，不可持续
最易被忽略的一点：即使你用尽技巧让两个版本“共存”，只要它们导出相同类名或函数名，PHP 在第一次 class_exists() 或 function_exists() 检查时就会 fatal error。真正的隔离必须发生在语言层之上，而非 Composer 配置层。
