config.vendor-dir仅支持单路径，无法实现多版本并存；正确做法是用独立项目、path仓库或符号链接隔离版本。
config.vendor-dir 只能设一个路径，不支持多版本并存
Composer 本身没有“多版本组件安装路径”这个概念。你不能让 monolog/monolog v2 和 v3 同时装在不同目录下——它不是包管理器的职责，而是由依赖解析和自动加载机制决定的：同一项目中，每个包名+版本组合只能存在一份，且必须统一放在 vendor（或你配置的 vendor-dir）下。
常见误解是想用路径隔离来“共存多个大版本”，比如把 laravel/framework 9.x 放 vendor-l9/、10.x 放 vendor-l10/。这不可行，原因有三：
-
composer install不接受多 vendor 目录；config.vendor-dir是单值字符串，无法写成数组或条件表达式 - 自动加载器（
vendor/autoload.php）生成时硬编码了所有 PSR-4/PSR-0 映射路径，它只认一个根目录 - 依赖冲突检测、符号链接生成、bin 文件软链等全部基于单一
vendor结构，拆分会直接导致Class not found或Command not found
真要隔离多版本？用独立项目 + 符号链接或子模块
如果你需要同时开发/测试多个大版本（比如 Laravel 9 和 10 的插件），正确做法不是改 Composer 路径，而是物理隔离：
- 为每个版本建独立项目目录，各自跑
composer install，互不干扰 - 用
git submodule或git subtree把你的扩展包作为子模块嵌入各版本项目中，便于同步修改 - 本地开发时可手动建立符号链接：
ln -sf /path/to/my-plugin src/MyPlugin，再在autoload-dev中加 PSR-4 映射，绕过 vendor 加载 - CI 流水线里用矩阵构建（matrix build）：对同一份代码，分别在 Laravel 9 和 10 的 Docker 环境中执行
composer install，不共享 vendor
注意：别试图用 installer-paths 给同一个包的不同版本配不同路径——它只按 type 或包名匹配，不识别版本号。
替代方案：用 Composer 的 path repository 指向本地多版本源码
若目标是方便调试多个版本的私有组件（如 myorg/core v1.2 和 v2.0），推荐用 path 类型仓库，而不是改安装路径：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "path",
"url": "../myorg-core-v1"
},
{
"type": "path",
"url": "../myorg-core-v2"
}
],
"require": {
"myorg/core": "dev-main as 1.2.0"
}
}
这样你可以：
- 在
../myorg-core-v1和../myorg-core-v2里分别维护不同分支或标签 - 通过
composer require myorg/core:dev-main切换版本，Composer 会自动软链到对应目录 - 所有自动加载、类型提示、IDE 索引都正常，因为软链后仍处于标准
vendor/结构内
这是官方支持、零配置风险的方式，比任何路径 hack 都稳定。
容易被忽略的关键点：autoload 的版本感知能力极弱
无论你怎么折腾路径，PHP 自动加载器本身不区分版本。它只根据类名查文件路径，而路径由 composer.json 中的 autoload 字段决定。哪怕你把 v2 的包硬拷到 vendor-v2/ 并改了 require 'vendor-v2/autoload.php'，只要里面声明的 PSR-4 前缀和 v1 完全一样，就会发生类覆盖或找不到类的问题。
真正可控的版本隔离，只发生在 Composer 解析阶段（composer.lock 锁定版本）、运行时（通过 class_alias 或命名空间前缀区分），而不是靠文件系统路径分隔。
