默认安装到项目根目录的 vendor/ 文件夹；路径写死在 autoload 机制中，手动改名或移动会导致 class not found 错误。
composer install 默认装到哪里？
默认情况下，composer install 会把所有依赖包解压并安装到项目根目录下的 vendor/ 文件夹里，不会自动支持换路径。这不是配置项缺失，而是 Composer 的设计原则：一个项目对应一个 vendor，路径写死在 autoload 机制和 autoloader 生成逻辑里。
常见错误现象：
– 手动改 vendor 名字或移动它 → autoload.php 找不到类，报 Class not found
– 在 composer.json 里加 "vendor-dir" 但没生效 → 实际是旧版（
想换 vendor 目录，只能靠 COMPOSER_VENDOR_DIR 环境变量
这是目前唯一稳定、被官方文档明确支持的自定义方式，且只影响安装位置，不影响 autoloader 生成逻辑（只要路径一致就行）。
使用场景：
– 多项目共享同一份依赖缓存（不推荐，但有人这么干）
– 部署时规避 vendor 被误删或权限问题
– CI/CD 中统一管理依赖输出路径
实操建议：
– Linux/macOS 下运行前设置：
COMPOSER_VENDOR_DIR="/path/to/my-vendor" composer install
– Windows（CMD）下：
set COMPOSER_VENDOR_DIR=C:\myproject\deps && composer install
– Windows（PowerShell）下：
$env:COMPOSER_VENDOR_DIR="C:\myproject\deps"; composer install
– 想永久生效？写进 shell 配置或 CI 脚本，**不要**写进
composer.json
vendor 路径变了，autoload.php 怎么找对？
Composer 生成的 vendor/autoload.php 是相对路径硬编码的，它默认假设自己就在 vendor/ 下。一旦你用 COMPOSER_VENDOR_DIR 换了位置，就得同步调整代码里 require 的路径。
容易踩的坑：
– 还写 require 'vendor/autoload.php'; → 报错 failed to open stream
– 忘了改 composer dump-autoload 之后的路径引用 → 类依然加载失败
正确做法：
– 所有 require 都改成动态路径：
require __DIR__ . '/my-vendor/autoload.php';
– 或者用环境变量兜底（更健壮）：
$vendorDir = $_ENV['COMPOSER_VENDOR_DIR'] ?? 'vendor';<br>require __DIR__ . '/' . $vendorDir . '/autoload.php';
– 不要试图 patch
vendor/autoload.php，下次 install 或 update 会被覆盖
为什么不能用 config.platform.vendors 或插件强行改路径？
因为 Composer 的依赖解析、包下载、autoloader 生成、classmap 构建全依赖于 vendor 目录结构的一致性。任何绕过 COMPOSER_VENDOR_DIR 的 hack（比如 symlink、post-install 脚本挪目录、自定义 installer）都会导致：
– composer dump-autoload -o 生成的 classmap 路径错乱
– composer show --tree 显示依赖关系异常
– 第三方插件（如 hirak/prestissimo）行为不可预测
– PHPStan / Psalm 静态分析找不到符号
性能与兼容性影响：
– COMPOSER_VENDOR_DIR 是零成本的环境变量透传，无额外开销
– 其他方案往往引入额外 I/O、符号链接权限问题、Windows 路径兼容性断裂
一句话：路径可以换，但必须从环境变量这一入口统一控制，其他都是给自己埋雷。
真正麻烦的不是换目录本身，而是后续所有路径引用、CI 配置、IDE 索引、静态分析工具都要同步感知这个变量 —— 它不像改个配置项那么简单，而是一个项目级契约。
