唯一真正生效的方式是配置config.vendor-dir字段：必须写在项目根目录composer.json中，值为相对路径（如"third-party"），且需先删除旧vendor目录再执行composer install。
唯一真正生效的 vendor 目录自定义方式，是配置 config.vendor-dir 字段——其他所有“技巧”要么无效，要么只在极少数边界场景起作用。
config.vendor-dir 是唯一全命令一致生效的路径配置
它被 composer install、composer update、composer require 全部识别，且优先级高于环境变量和 -d 参数。但有三个硬性前提：
- 必须写在项目根目录的
composer.json里，不能放在全局或子目录中 - 值必须是相对路径，比如
"third-party"✅，不能是/var/www/myapp/third-party或/third-party❌ - 只在
vendor/目录不存在时才起作用；已存在旧vendor，Composer 不会移动它，也不会把新包写到新路径
常见翻车：先 composer install 生成了默认 vendor/，再补加 config.vendor-dir —— 此时改完配置也没用，必须手动删掉现有 vendor 目录，再运行 composer install（不是 dump-autoload）。
COMPOSER_VENDOR_DIR 和 -d 参数为什么靠不住
很多人以为 COMPOSER_VENDOR_DIR=/path/to/vendor composer install 能换位置，实际行为很不稳定：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 该环境变量仅在
composer.json中未声明config.vendor-dir时才生效，优先级更低 - 在 Docker 容器、Git Bash、某些 CI 环境下会被忽略或解析错误
-
composer -d /some/path install只是告诉 Composer 去哪找composer.json和composer.lock，完全不改变vendor写入位置——本地跑通但 CI 报Class not found就是因为这个
结论：别依赖它们做生产级路径控制，只适合临时调试或脚本兜底。
extra.installer-paths 只对特定 type 的包生效
这个字段常被误认为是“全局 vendor 替换方案”，但它其实是 composer/installers 插件的能力，只影响声明了明确 type 的包：
- 普通 PHP 库（如
monolog/monolog）完全不受影响 - 必须先
composer require composer/installers，否则整个字段被忽略 - 路径值是相对于项目根目录的，不支持以
/开头，例如"wp-content/plugins/{$name}/"✅ - 规则按顺序匹配，只取第一个命中项；已安装的包不会自动迁移，删
vendor后重装才生效
典型用途：WordPress 插件、Drupal 模块这类生态型包的安装路径定制，不是用来改 vendor/ 根目录的。
真正要改整个项目的依赖安装位置，就只有一条路：config.vendor-dir + 删旧 vendor + 重装。任何绕过这三步的操作，都会在某个环节暴露路径错乱、类加载失败或 CI 构建失败的问题——尤其当项目进入多人协作或容器化部署阶段，这点最容易被忽略。
