唯一可靠方式是在composer.json的config中设置"vendor-dir"，必须删除旧vendor后执行install/update；环境变量COMPOSER_VENDOR_DIR在Composer 2.2+仅部分命令生效，不改变实际安装路径。
Composer 的 vendor-dir 路径不能靠运行时参数临时指定，也不能用软链接“假装”改名——必须在安装前就明确告诉 Composer 写到哪，否则类加载、自动补全、部署脚本全都会出问题。
config.vendor-dir 是唯一被全命令支持的配置方式
它写在项目根目录的 composer.json 里，优先级最高，对 install、update、require 全部生效。老教程里说它“已废弃”是错的，2026 年最新版（2.5+）仍完全支持且推荐使用。
-
vendor-dir值必须是相对路径（如"lib/vendor"），不能以/开头，也不能含.. - 父目录（比如
lib/）得手动提前创建好，Composer 不会自动建多层目录 - 改完后必须删掉旧
vendor目录，再跑composer install——update不会把已有包挪过去 - 如果项目已有
autoload.files或自定义bin脚本，检查它们是否还硬编码了vendor/字符串
COMPOSER_VENDOR_DIR 环境变量只在部分场景可靠
它确实能覆盖 config.vendor-dir，但仅限 install 和 update；像 dump-autoload、run-script 这类命令压根不读这个变量。CI/CD 中用它做一次性的路径切换没问题，但别指望它让整个开发流程“自动适配”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 PowerShell：
$env:COMPOSER_VENDOR_DIR="third-party"; composer install - 设为系统环境变量后，所有本地项目都会受影响——团队协作时容易引发路径混乱
- 实测发现：设了
COMPOSER_VENDOR_DIR=libs后跑composer install，依赖确实装进libs/，但vendor/autoload.php文件本身仍会被生成（空壳），且内容里写的还是__DIR__ . '/vendor/composer/...'—— 这是历史遗留逻辑，别信它
autoload.php 路径必须手动同步更新
Composer 不会帮你改代码里的 require 'vendor/autoload.php'。哪怕你把依赖装到了 third-party/，入口文件（比如 public/index.php）里那行 require 还是指向不存在的 vendor/，直接报 Fatal error: require(): Failed opening required 'vendor/autoload.php'。
- 改成绝对路径：
require __DIR__ . '/../third-party/autoload.php'; - 或动态拼接：
$vendorDir = getenv('COMPOSER_VENDOR_DIR') ?: 'vendor'; require __DIR__ . "/../{$vendorDir}/autoload.php"; -
composer dump-autoload完全没用——它只重生成类映射，不碰路径引用 - IDE（如 PHPStorm）默认只扫描
vendor/目录做类型索引，换名后要手动添加新路径到 “Include Paths”
部署和工具链最容易漏掉的三件事
改 vendor-dir 最难的不是配置本身，而是下游生态根本没为它设计。很多工具默认只认 vendor/ 这个名字，一换就失联。
- 安全扫描器（如 SensioLabs Security Checker、PHPStan）可能跳过新目录，漏报漏洞
- Docker 构建中若用
COPY . /app，记得确认.dockerignore里没误 exclude 掉新 vendor 目录名 - 某些部署脚本或 CI 模板里硬写了
rm -rf vendor && composer install，得同步改成对应目录名
真正麻烦的从来不是“怎么让 Composer 把包装到别的地方”，而是“怎么让所有依赖它的环节都意识到：vendor 已经不叫 vendor 了”。
