Composer修改默认安装路径_Composer自定义vendor目录教程-composer-PHP中文网

composer 2.0+ 中 config.vendor-dir 已彻底废弃，唯一可靠方式是环境变量 composer_vendor_dir；它优先级最高、全命令生效，但需同步更新 autoload 引用及所有硬编码路径。

composer修改默认安装路径_composer自定义vendor目录教程

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 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 内部拼接路径）都得你手动对齐，漏一处就报错。