Composer设置安装路径在哪 Composer自定义部署位置【指南】-composer-PHP中文网

composer 2.0+ 中 config.vendor-dir 已彻底废弃，唯一可靠方式是环境变量 composer_vendor_dir；单包路径需依赖 composer/installers 插件及 extra.installer-paths 配置，且仅对声明了特定 type（如 wordpress-plugin）的包生效。

composer设置安装路径在哪 composer自定义部署位置【指南】

Composer 没有“安装路径设置”的全局配置项，也没有命令行参数能直接指定 vendor 目录位置；所谓“自定义安装路径”，实际只有两种可靠路径：改整个项目的 vendor 目录（用 COMPOSER_VENDOR_DIR 环境变量或旧版 config.vendor-dir），或对特定 type 的包用 installer-paths 单独挪动——其他方式基本无效或已废弃。

composer.json 里的 config.vendor-dir 还管用吗

在 Composer 2.0+（当前主流版本）中，config.vendor-dir 已被彻底移除。你写进 composer.json 里，composer install 不会报错，但也不会生效，反而会输出警告：The "config.vendor-dir" option is deprecated, use the "COMPOSER_VENDOR_DIR" environment variable instead.

该配置项只在 Composer 1.x 中有效；2026 年所有稳定发行版（包括 2.5、2.6）均不再识别它
composer diagnose 会明确标出这一项为弃用配置
即使你删了 vendor/ 再跑 composer install，包依然会装进默认 vendor/，不是你写的路径

COMPOSER_VENDOR_DIR 是唯一靠谱的环境级方案

COMPOSER_VENDOR_DIR 是 Composer 2.0+ 官方唯一支持、全命令生效（install、update、require 都认）的 vendor 路径控制方式。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Linux/macOS：COMPOSER_VENDOR_DIR=lib/vendor composer install
Windows CMD：set COMPOSER_VENDOR_DIR=lib/vendor && composer install
PowerShell：$env:COMPOSER_VENDOR_DIR="lib/vendor"; composer install
路径支持相对路径（如 lib/vendor）和绝对路径（如 /var/www/myapp/lib/vendor），但避免以 / 开头的“伪绝对路径”（如 /lib/vendor），否则 Windows 下可能解析失败
该变量优先级高于项目配置；一旦 composer.json 里存在 config.vendor-dir，它会被忽略（不是覆盖，是跳过）

installer-paths 只对特定 type 的包生效

installer-paths 不是“把任意包装到任意目录”的通用开关，它依赖 composer/installers 插件 + 包自身声明的 type 字段（如 wordpress-plugin、drupal-module），普通 library 类型包默认不触发。

必须先运行 composer require composer/installers，否则 extra.installer-paths 配置完全无效
目标包的 composer.json 必须声明匹配的 type，例如：{"type": "wordpress-plugin"}
路径中可用 {$name} 或 {$vendor} 占位符，但路径必须以 / 结尾（如 wp-content/plugins/{$name}/）
想让私有包走定制路径？得在它的 composer.json 里设一个新 type（如 myapp-extension），再在主项目 extra.installer-paths 中映射该 type

改完路径后 Class not found 是最常踩的坑

无论用 COMPOSER_VENDOR_DIR 还是 installer-paths，Composer 都不会自动修复你代码里硬编码的路径引用。

require 'vendor/autoload.php' 必须手动改成 require 'lib/vendor/autoload.php'，或改用动态拼接：require __DIR__ . '/lib/vendor/autoload.php';
vendor/bin/phpunit 要同步改为 lib/vendor/bin/phpunit，CI 脚本、$PATH、Makefile、Dockerfile 全得扫一遍
PHPStorm 默认只索引 vendor/，需手动在 Settings → PHP → Include Paths 中添加新路径
某些框架脚本（如 Laravel 的 artisan 或 Symfony 的 console）内部拼了 vendor 字符串，得查源码或 patch

真正麻烦的从来不是“怎么改路径”，而是“改完之后，有多少地方悄悄依赖了 vendor 这个字符串”。漏掉一处，就 Class not found。