最可靠方式是通过 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 还是按原配置写进默认位置。

Evez Github Manager

在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。

下载

• 这个参数本质是切换工作上下文，不是路径重定向
• 若想配合自定义 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

路径一动，整个依赖链的“坐标系”就偏了，最麻烦的往往不是安装那一下，而是后续所有隐式引用它的环节。