Composer 不允许将 vendor 目录设在项目外，因会破坏自动加载、脚本执行和依赖解析；推荐方案包括共享缓存（COMPOSER_HOME）、path repository 复用本地包，或谨慎修改 vendor-dir 仅限单项目隔离场景。
Composer 默认把所有包装进项目根目录下的 vendor 文件夹，但你不能直接让它把包装到 vendor 外面——这不是 Composer 的设计目标，强行绕过会破坏自动加载、脚本执行和依赖解析。不过，有几种实用且稳定的替代方案，取决于你的真实需求。
为什么不能用 COMPOSER_VENDOR_DIR 指向非 vendor 目录？
你可以用环境变量 COMPOSER_VENDOR_DIR 或 composer.json 里的 "config": {"vendor-dir": "..."} 改变路径，但它仍必须是项目内部的子目录（比如 libs 或 packages），且必须满足：
• autoload 机制依赖该路径生成 vendor/autoload.php
• 所有第三方包的 autoload 配置（如 PSR-4）都默认基于这个目录做相对解析
• 若指向项目外（如 /opt/my-packages），composer dump-autoload 会失败，require 时类找不到，插件脚本也大概率不执行
想复用包又不想重复下载？用 COMPOSER_HOME + cache-dir
真正节省磁盘和加速安装的，不是挪 vendor，而是共享 Composer 缓存。多个项目共用同一份已下载的 ZIP/源码包，无需反复拉取：
- 设置全局缓存目录：
export COMPOSER_HOME="/path/to/shared/composer"（Linux/macOS）或set COMPOSER_HOME=C:\shared\composer（Windows） - 或在
composer.json中配："config": { "cache-dir": "/path/to/shared/composer/cache" } - 这样
vendor还在项目里，但每次install都优先从本地缓存解压，速度接近离线安装
需要跨项目共享自定义包？走 path repository + repositories
如果你有一组内部工具包，希望多个项目“引用”而不是“复制”，正确做法是用本地路径仓库：
- 在主项目的
composer.json中添加："repositories": [ { "type": "path", "url": "../my-utils-package" } ] - 然后
composer require my-vendor/my-utils:dev-main（注意版本要匹配composer.json里的"version"或用dev-前缀） - Composer 会创建符号链接（Linux/macOS）或复制（Windows，默认），且修改源码实时生效，适合开发阶段
- 上线前可切回 packagist 或私有 repo，无需改业务代码
真要 vendor 在别处？只限单项目隔离场景
仅当你明确接受以下代价时，才考虑改 vendor-dir：
- 必须确保所有 CI/CD 脚本、Dockerfile、部署工具都同步更新该路径
-
autoload.php的引入路径要手动调整（比如require __DIR__.'/libs/autoload.php';） - 某些依赖（如 Laravel Mix、PHPStan 插件）可能硬编码找
vendor/bin，需额外配置bin-dir - 升级 Composer 自身后，旧版
vendor-dir配置可能被忽略，建议始终用COMPOSER_VENDOR_DIR环境变量而非 JSON 配置
最常被忽略的是 autoload 与 bin 脚本的耦合——哪怕 vendor 移走了，composer install 仍会按新路径生成 autoload 文件，但框架或工具若没读取 Composer 配置，就只能靠人工对齐。
