直接修改 composer.json 的 "vendor-dir" 即可,但需用合法相对路径(如 "lib_composer"),删除旧 vendor 目录后执行 install,并同步更新所有硬编码 vendor/ 的路径。

直接改 composer.json 的 "vendor-dir" 就行,但得注意它只在当前项目生效,且不能用相对路径别名(比如 ./lib_composer)——必须是相对于 composer.json 的真实相对路径或绝对路径。
vendor-dir 配置写法和生效范围
这个配置只影响当前项目的依赖安装位置,不影响全局行为。它不是命令行参数,也不是环境变量,而是纯 JSON 配置项,必须放在 composer.json 根对象里。
- 正确写法:
"vendor-dir": "lib_composer"(推荐,相对路径,生成./lib_composer/) - 错误写法:
"vendor-dir": "./lib_composer"(./会被忽略,实际还是变成lib_composer) - 错误写法:
"vendor-dir": "lib_composer/"(末尾斜杠会导致 Composer 报错:Invalid value for vendor-dir: must be a valid directory name) - 如果想用绝对路径(不推荐):
"vendor-dir": "/var/www/myapp/lib_composer",但会破坏可移植性
执行 install/update 前必须删掉旧 vendor 目录
Composer 不会自动移动已有依赖,也不会提示你旧目录残留。如果你之前用默认 vendor/ 装过包,又加了 "vendor-dir",直接 composer install 会报错或行为异常——它可能仍读旧 vendor/ 的 autoload,却往新目录写文件。
- 先手动删掉原来的
vendor/目录 - 确认
composer.lock文件存在(否则install会退化为update,重新解析依赖) - 再运行
composer install,它就会按新路径创建lib_composer/并装包
autoload 和脚本路径不会自动适配
"vendor-dir" 只改依赖存放位置,不改自动加载逻辑的推导方式。Composer 生成的 vendor/autoload.php(现在其实是 lib_composer/autoload.php)本身没问题,但如果你在代码里硬编码了 vendor/autoload.php 路径,或者在 composer.json 的 "scripts" 里写了 php vendor/autoload.php 这类调用,就会出错。
- 所有硬编码
vendor/的地方,都要同步改成lib_composer/ -
"autoload"段里的"psr-4"映射不受影响,不用动 - CI/CD 脚本、Dockerfile 中显式 COPY 或 RUN 的路径也要检查,比如
COPY vendor/ /app/vendor/得改成COPY lib_composer/ /app/lib_composer/
真正麻烦的不是设这个字段,而是它不触发任何警告或迁移提示——你改完以为好了,结果测试时 autoload 失败、脚本找不到文件、CI 构建报错,才意识到到处都有隐式依赖。最稳妥的做法:改完立刻 git grep -n "vendor/" 扫一遍项目。










