唯一可靠方式是在 composer.json 的 config 中设置 "vendor-dir"，必须删除旧 vendor 后执行 install/update；环境变量 composer_vendor_dir 在 composer 2.2+ 仅部分命令生效，不改变实际安装路径。

composer.json 里用 config.vendor-dir 指定目录名

Composer 不支持运行时参数改 vendor 路径，唯一可靠方式是提前在项目根目录的 composer.json 里声明。它不是全局配置，只对当前项目生效。

常见错误是去改 composer.phar 或试图用环境变量覆盖 —— 这些都不起作用。

• 在 composer.json 的 config 对象下添加 "vendor-dir": "lib/vendor"（路径可相对，不以 / 开头）
• 必须先删掉原有 vendor 目录，再执行 composer install 或 composer update
• 路径不能包含变量或通配符，比如 "vendor-dir": "${HOME}/my-vendor" 会直接报错 Invalid config key 'vendor-dir'
• 如果项目已存在 autoload 配置（如 autoload.files），需同步检查路径是否还指向旧 vendor 下的文件

为什么不能用 COMPOSER_VENDOR_DIR 环境变量？

这个环境变量在 Composer 2.2+ 才被正式支持，但仅限于某些特定场景：它只影响 composer dump-autoload 和部分内部路径解析，不会改变 install 或 update 时实际创建的目录位置。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

实测中设了 COMPOSER_VENDOR_DIR=lib/ext 后跑 composer install，依然生成默认 vendor，且自动加载器仍写死引用该目录。

• 真正生效的只有 composer dump-autoload --classmap-authoritative 这类命令中的临时路径判断
• PHP 加载器（如 vendor/autoload.php）始终按 composer.json 里的 config.vendor-dir 生成，和环境变量无关
• CI/CD 中误信文档而设此变量，结果部署后找不到类，是高频翻车点

改完 vendor-dir 后 Autoload 失效怎么办？

不是 Composer 忘了重生成 autoload，而是它生成的 autoload.php 里硬编码了新路径，但你的代码可能还通过旧路径 require 它，或者 Web 服务器没刷新 opcode 缓存。

• 确认 vendor/autoload.php 文件确实出现在你设的新路径下（比如 lib/vendor/autoload.php）
• 检查所有 require 或 include 语句，把 vendor/autoload.php 改成对应新路径
• 如果用了 OPCache，执行 opcache_reset() 或重启 PHP-FPM，否则可能还在用旧 autoload 的缓存字节码
• composer dump-autoload -o 不会改变路径，只优化映射表；路径由 install/update 阶段决定

自定义 vendor 目录对部署和 Git 的影响

改名本身不改变依赖逻辑，但会影响工具链感知。很多脚本、IDE 插件、安全扫描器默认只扫 vendor，一换名就漏报。

• Git 忽略规则要同步更新：lib/vendor/ 而非 vendor/，否则可能意外提交大量依赖文件
• Docker 构建时若用 COPY . .，确保 .dockerignore 也排除了新 vendor 路径
• 某些 SaaS 扫描服务（如 GitHub Dependabot）目前不识别自定义 vendor 路径，依赖更新提示会失效
• 如果你用的是 symlink 方式部署（如 Laravel Envoyer），注意软链目标路径也要跟着 vendor-dir 变动

改 vendor 名这事，表面只是换个文件夹，实际牵扯 autoload 生成、部署路径、工具链适配三层。最常被忽略的是：改完 composer.json 后没删旧 vendor 就直接 install，结果新旧目录并存，autoload 却混用，报错时连问题源头都难定位。