最可靠方式是通过 composer.json 的 config.vendor-dir 设置 vendor 目录路径，它优先级最高、全命令生效且官方完全支持；需删除旧 vendor 后重新 install，并同步更新 autoload、IDE 路径及硬编码引用。
composer.json 里用 config.vendor-dir 指定路径最可靠
Composer 官方支持通过 config.vendor-dir 控制 vendor 目录位置，这是唯一被完全兼容的方式。它优先级高于命令行参数和环境变量，且对所有命令（install、update、require）生效。
在项目根目录的 composer.json 中添加：
{
"config": {
"vendor-dir": "lib/vendor"
}
}
- 路径是相对于
composer.json所在位置的，不支持绝对路径（如/var/www/vendor） - 修改后需删掉旧
vendor目录再运行composer install，否则残留文件可能引发自动加载错误 - 如果项目含多个子模块共用同一 Composer 配置，该设置会统一影响全部，注意路径冲突
用 -d 参数临时切换配置目录不等于改 vendor 路径
composer -d /path/to/project install 只是告诉 Composer 去哪找 composer.json 和 composer.lock，它不会改变 vendor-dir 的解析逻辑。很多人误以为加了 -d 就能“换地方装”，其实 vendor 还是按原配置写进默认位置。
- 这个参数本质是切换工作上下文，不是路径重定向
- 若想配合自定义 vendor，仍需在目标项目的
composer.json里显式设config.vendor-dir - CI/CD 脚本中滥用
-d而忽略配置一致性，容易导致本地能跑、流水线报Class not found
全局配置 COMPOSER_VENDOR_DIR 环境变量只在特定场景生效
设置 COMPOSER_VENDOR_DIR=lib/vendor 后，只有当 composer.json 里没声明 config.vendor-dir 时，该变量才起作用。一旦项目配置存在，环境变量会被直接忽略。
- 适合多项目共用一套脚手架但不想改每个
composer.json的运维场景 - Windows 下需用
set COMPOSER_VENDOR_DIR=lib\vendor，反斜杠要转义或用正斜杠 - Git Bash 或 WSL 中该变量可能被 shell 层过滤，建议优先走
composer.json配置
改完 vendor 路径后，autoload 和 IDE 支持要手动同步
Composer 修改 vendor-dir 不会自动更新 vendor/autoload.php 的内部路径计算逻辑——它本身是动态生成的，这部分没问题；但真正容易出问题的是外部依赖。
-
psr-4映射、classmap生成、include-path等仍基于原始vendor假设，需确保composer dump-autoload在新路径下执行 - PHPStorm 等 IDE 默认只扫描
vendor目录，需手动在 Settings → PHP → Include Paths 中添加新路径 - 某些插件（如 PHPUnit 的
--bootstrap）硬编码了vendor/autoload.php，得同步改成lib/vendor/autoload.php
路径一动，整个依赖链的“坐标系”就偏了，最麻烦的往往不是安装那一下，而是后续所有隐式引用它的环节。
