--working-dir 用于指定 composer.json 所在目录,决定项目根路径和 vendor 生成位置;COMPOSER_VENDOR_DIR 仅修改 vendor 子目录名;自定义 vendor 路径需通过 config.vendor-dir 配置且不支持绝对路径。

composer install 时如何用 --working-dir 指定项目根目录
不能直接指定“输出路径”,但可以通过改变工作目录,让 vendor 落在任意位置。关键不是“输出到哪”,而是“从哪开始解析 composer.json”。--working-dir 是最常用且可靠的参数,它强制 Composer 把指定路径当作项目根目录来加载配置和写入 vendor。
常见错误是误以为 --install-dir 或 --target 存在——它们并不存在于 Composer CLI 中。也有人尝试改 COMPOSER_VENDOR_DIR 环境变量,但它只控制 vendor 目录名,不改变位置。
- 必须确保目标路径下存在有效的
composer.json,否则报错Could not find a composer.json file in ... - 执行命令前当前 shell 工作目录无关紧要,
--working-dir才是决定性参数 - 示例:
composer install --working-dir=/path/to/my/project→vendor就生成在/path/to/my/project/vendor
用 COMPOSER_VENDOR_DIR 环境变量控制 vendor 子目录名(非路径)
这个变量只能改 vendor 文件夹叫什么,比如改成 libs 或 deps,但它依然会出现在项目根目录下,不会跳到别的磁盘路径。很多人混淆了“目录名”和“目录路径”。
- Linux/macOS:
COMPOSER_VENDOR_DIR=libs composer install - Windows(cmd):
set COMPOSER_VENDOR_DIR=libs && composer install - 它不影响
autoload逻辑,Composer 自动适配新目录名 - 如果同时用了
--working-dir,COMPOSER_VENDOR_DIR仍只作用于那个工作目录下的子目录
想把 vendor 放到项目外?得靠 composer.json 的 config.vendor-dir
这是真正能“自定义路径”的方式,但必须提前写进 composer.json,且路径是相对于项目根目录的。不支持绝对路径(Composer 会拒绝),也不支持上级目录穿越(如 ../shared/vendor)会触发警告或失败。
示例:在 composer.json 里加
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"config": {
"vendor-dir": "var/vendor"
}
}
之后运行 composer install,vendor 就落在 var/vendor。注意:
- 修改后需删掉旧
vendor目录再重装,否则 autoload 可能混乱 -
vendor-dir是 Composer 早期遗留配置,官方已标记为 deprecated,但目前仍有效 - 它无法通过命令行参数临时覆盖,只能靠配置文件
为什么没有 --output-dir 这种参数?
因为 Composer 的设计模型是“项目为中心”,所有操作都锚定在 composer.json 所在位置。它的职责是管理依赖及其自动加载,不是通用文件拷贝工具。强行把 vendor 放到别处会破坏 autoloader 的路径推导、插件加载机制,甚至导致 composer dump-autoload 失效。
如果你真需要把最终依赖文件“导出”到其他路径,正确做法是:先在标准位置完成 install,再用 rsync 或 cp 拷贝 vendor,或者用 composer archive 打包后解压——而不是指望 Composer 自己跨目录写入。
最容易被忽略的一点:vendor 目录的位置一旦变化,所有基于相对路径的脚本(比如 PHPUnit 配置、部署脚本里的 require_once)都得同步更新,否则运行时就报 Class not found。

















