最直接的方式是在 composer.json 的 config 字段中设置 vendor-dir，如 {"config": {"vendor-dir": "libs"}}，它会覆盖默认路径且优先级高于环境变量；需同步修改 autoload 引用、IDE 配置及工具链路径。
composer.json 里用 config.vendor-dir 指定目录
最直接的方式是在项目根目录的 composer.json 中添加 config 字段，通过 vendor-dir 控制安装路径。它会覆盖全局或默认行为，且优先级高于环境变量。
示例：
{
"config": {
"vendor-dir": "libs"
}
}
执行 composer install 或 composer update 后，所有包都会装进 libs/ 而非默认的 vendor/。
- 该配置只对当前项目生效，不影响其他项目
- 路径支持相对路径（如
"libs"）和绝对路径（如"/var/www/myproject/packages"），但绝对路径在协作中容易出问题，不推荐 - 修改后记得删掉旧
vendor/目录，否则自动加载可能仍引用旧路径
用 COMPOSER_VENDOR_DIR 环境变量临时覆盖
适合 CI/CD、Docker 构建或单次调试场景，无需改 composer.json。设置环境变量后，Composer 会优先读取它。
Linux/macOS：
COMPOSER_VENDOR_DIR=third-party composer install
Windows（PowerShell）：
$env:COMPOSER_VENDOR_DIR="third-party"; composer install
- 环境变量方式不会写入配置文件，适合临时切换，但容易被忽略——比如在 Dockerfile 中漏设，导致构建时仍用默认
vendor/ - 如果同时设置了
config.vendor-dir和环境变量，环境变量胜出 - PHP 运行时不会自动感知这个变量，
autoload.php的路径由composer.json配置或生成逻辑决定，所以仅靠环境变量不能让require 'vendor/autoload.php'自动适配；必须同步调整代码里的引入路径
修改 vendor 目录后，自动加载路径没更新？
Composer 生成的 autoload.php 和 ClassLoader 是根据实际安装路径硬编码的。如果你把目录从 vendor 改成 libs，但代码里还写 require 'vendor/autoload.php'，就会报错 failed to open stream: No such file or directory。
- 必须同步修改所有引用
vendor/autoload.php的地方，改成libs/autoload.php - Laravel、Symfony 等框架通常在入口文件（如
public/index.php）里 require 自动加载器，这里最容易漏改 - 某些工具（如 PHPUnit 的
phpunit.xml）也可能显式指定bootstrap路径，需要一并检查 - 运行
composer dump-autoload不会修复路径错误——它只重生成映射，不改文件位置或引用
vendor 目录名改了，IDE 和静态分析还能识别吗？
大多数 PHP IDE（PhpStorm、VS Code + Intelephense）默认只扫描 vendor/ 下的类。改名后，类型提示、跳转定义、自动补全大概率失效。
- PhpStorm：需手动在
Settings > Directories中将新目录（如libs）标记为 “Sources” 或 “Libraries” - VS Code + Intelephense：在工作区设置里加
"intelephense.environment.includePaths": ["libs"] - PHPStan / Psalm 等静态分析工具默认不扫描
vendor外路径，需在配置中显式添加 autoload 路径或 stubs - Git 忽略规则（
.gitignore）也要同步更新，避免误提交新目录内容
真正麻烦的不是改名本身，而是所有依赖路径、工具链和团队约定都要跟着动——一个没对齐，就卡在“明明装好了却找不到类”的状态里。
