Composer 2.0+ 中 config.vendor-dir 已彻底废弃，唯一可靠方式是环境变量 COMPOSER_VENDOR_DIR；它优先级最高、全命令生效，但需同步更新 autoload 引用及所有硬编码路径。
Composer 2.0+ 中，config.vendor-dir 已被彻底废弃，设了不仅无效，还会触发警告；唯一可靠、全命令生效（install、update、require）的方式是环境变量 COMPOSER_VENDOR_DIR。
为什么改了 composer.json 的 vendor-dir 没用？
这是最常踩的坑：你加了 "config": {"vendor-dir": "lib/vendor"}，运行 composer install 后 vendor 还在原处，并弹出警告：The "config.vendor-dir" option is deprecated, use the "COMPOSER_VENDOR_DIR" environment variable instead.
- Composer 2.0 起已完全忽略该配置项，不是“没生效”，而是主动跳过
-
composer diagnose会明确列出这条弃用提示 - 旧教程里复制的 JSON 片段在当前版本属于无效代码，别再往
composer.json里硬塞
怎么用 COMPOSER_VENDOR_DIR 正确指定路径？
它优先级最高，且不依赖项目配置是否存在，所有 Composer 命令都认。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 临时执行：
COMPOSER_VENDOR_DIR=third-party composer install - Windows CMD：
set COMPOSER_VENDOR_DIR=third-party && composer install - PowerShell：
$env:COMPOSER_VENDOR_DIR="third-party"; composer install - 永久生效：把
COMPOSER_VENDOR_DIR加进 shell 配置（如~/.zshrc）或系统环境变量，注意重启终端/IDE 才能加载 - 路径可以是相对路径（如
third-party）或绝对路径（如/var/www/myapp/third-party），但不要以/开头的“伪绝对路径”（如/third-party），Windows 下易解析异常
改完路径后 autoload.php 为啥还报错？
COMPOSER_VENDOR_DIR 只控制安装位置，不自动修复你的代码引用、IDE 设置或脚本调用。
-
require 'vendor/autoload.php'必须手动改成require 'third-party/autoload.php'，或改用动态写法：require __DIR__ . '/third-party/autoload.php'; -
vendor/bin/phpunit要同步改为third-party/bin/phpunit，CI 脚本、$PATH、Makefile 里所有硬编码都得扫一遍 - PHPStorm 默认只索引
vendor/，需手动去Settings → PHP → Include Paths添加新路径 -
composer dump-autoload本身没问题，但它生成的autoload.php是基于当前COMPOSER_VENDOR_DIR值写的，所以必须确保该变量在运行时已正确设置
installer-paths 能不能用来换普通包的位置？
不能。它只对声明了特定 type 的包生效（如 wordpress-plugin、drupal-module），且需额外插件支持。
- 前提是你已运行
composer require composer/installers - 目标包的
composer.json中必须有匹配的"type": "xxx" - 配置写在根项目的
extra.installer-paths下，例如：{"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]} - 普通库（
type: library）完全不受影响，哪怕写了规则也进不了指定目录
真正容易被忽略的是：环境变量只影响 Composer 的安装行为，不影响 PHP 运行时——require 语句、部署脚本、IDE 索引、甚至某些框架初始化逻辑（比如 Laravel 的 artisan 内部拼接路径）都得你手动对齐，漏一处就报错。
