composer如何设置vendor-dir_composer vendor目录自定义【路径】

最可靠方式是在composer.json的config块中设置”vendor-dir”: “path/to/vendor”，路径支持相对或绝对路径，修改后需删除旧vendor目录再执行composer install。

composer.json 里用 config.vendor-dir 指定路径

直接改 composer.json 最可靠，所有后续命令（composer install、composer update）都会生效。不是临时设置，也不是环境变量覆盖。

• 在 composer.json 的 config 块下加 "vendor-dir": "path/to/vendor"，路径是相对于 composer.json 所在目录的相对路径
• 绝对路径也支持，但写成 "vendor-dir": "/var/www/myapp/custom-vendor" 这种形式，注意权限和跨平台兼容性
• 如果项目已存在 vendor/ 目录，改完后必须先删掉旧目录再运行 composer install，否则 Composer 会报错或忽略新配置
• vendor-dir 不支持变量（比如 ${HOME} 或 ../lib），也不能用 ~ 表示用户主目录

为什么不用 COMPOSER_VENDOR_DIR 环境变量

环境变量方式看似方便，实际容易失效——它只影响当前 shell 会话，CI/CD 流水线、docker 容器、ide 内置终端都可能没加载它，导致行为不一致。

• linux/macos 下：运行前执行 export COMPOSER_VENDOR_DIR="my-vendor"，但下次新开终端就没了
• windows PowerShell：要用 $env:COMPOSER_VENDOR_DIR="my-vendor"，CMD 则是 set COMPOSER_VENDOR_DIR=my-vendor，写法不统一
• 某些共享主机或托管平台（如 laravel forge、paas）会重置环境变量，这个配置就完全不起作用
• 一旦和 composer.json 中的 vendor-dir 冲突，Composer 优先用 composer.json，环境变量被静默忽略

自定义 vendor 目录后，autoload 和 require 还能用吗

能用，但前提是自动加载配置没硬编码路径。Composer 自动生成的 vendor/autoload.php 会适配新位置，但你自己的代码如果写了 require 'vendor/autoload.php' 就会出错。

• 检查所有 require / include 语句，把写死的 'vendor/autoload.php' 改成动态定位，例如：require __DIR__ . '/path/to/vendor/autoload.php';
• Laravel、symfony 等框架通常通过 composer.json 的 autoload 配置生成映射，只要没在 bootstrap/autoload.php 之类文件里硬写路径，就没事
• 运行 composer dump-autoload 后，新 vendor 目录下的 autoload.php 会重新生成，但不会修复你代码里写死的路径

Windows 下路径斜杠和空格要特别小心

Windows 用户容易在这里翻车：反斜杠转义、路径含空格、长路径限制，都会让 Composer 报奇怪的错误，比如 Could not scan for classes 或 file_put_contents(): Invalid argument。

• 一律用正斜杠 /，哪怕在 Windows 上也写 "vendor-dir": "lib/vendor"，不要写 "libvendor"
• 路径别带空格，像 "My Projects/vendor" 很可能触发 PHP 的流包装器解析失败
• 如果路径很深（比如嵌套多层子目录），开启 Windows 长路径支持（ComputerHKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFilesystem@LongPathsEnabled = 1），否则 Composer 可能创建失败但报错不明确

改完 composer.json 后，真正容易被忽略的是：所有团队成员、CI 脚本、部署脚本、IDE 的路径索引，都要同步更新——不是改一个文件就完事了。