Composer怎么修改vendor路径 Composer怎么自定义包存放目录【配置】

直接在composer.json顶层添加”config”: {“vendor-dir”: “lib/vendor”}可指定新vendor目录，需删除旧vendor后运行composer install/update，路径须避免嵌套在原vendor内且注意跨平台兼容性。

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

直接改 vendor 目录，不是靠命令行参数或全局配置，而是改项目根目录下的 composer.json。只要加一行 config 配置就能生效，Composer 会优先读它。

• 在 composer.json 的顶层（和 require 同级）加：

  "config": {   "vendor-dir": "lib/vendor" }

• 路径支持相对路径（推荐），也支持绝对路径（如 /var/www/myapp/vendor），但绝对路径会让项目失去可移植性
• 改完后必须删掉旧 vendor 目录，再运行 composer install 或 composer update，否则 Composer 不会自动迁移文件
• 如果项目已提交了 vendor 到 git，记得把旧路径从版本控制里删掉，并更新 .gitignore（比如改成 lib/vendor/）

全局配置 COMPOSER_VENDOR_DIR 环境变量不推荐

环境变量方式确实能覆盖 vendor 路径，但它属于“强制干预”，容易在 CI、多项目共存或团队协作时出问题。

• 设置方式：export COMPOSER_VENDOR_DIR="/path/to/vendor（linux/macos）或 set COMPOSER_VENDOR_DIR=C:path oendor（windows）
• 它会跳过 composer.json 里的 config.vendor-dir，连带影响所有子命令（composer dump-autoload 也会找错地方）
• CI 脚本里误设该变量，会导致本地开发和构建环境行为不一致，debug 成本高
• 除非是临时调试或容器内固定路径场景，否则别用

修改后 autoload 和 bin 路径会自动适配

不用担心 PSR-4 自动加载或脚本命令失效——Composer 会根据新的 vendor-dir 重写 vendor/autoload.php 和 vendor/bin/ 下的可执行文件。

• vendor/autoload.php 仍可照常引入，路径逻辑由 Composer 内部处理，无需手动改 require
• 如果项目里硬编码了 vendor/autoload.php（比如某些部署脚本），要同步改成新路径，例如 lib/vendor/autoload.php
• bin 目录下的命令（如 phpunit、laravel）依然能用，但前提是它们没被 symlink 到系统 PATH；若用了 composer global，那和当前项目的 vendor-dir 无关

注意 vendor-dir 不能放在 vendor 内部或循环引用

这个坑很隐蔽：一旦配置值指向了 vendor 子目录（比如 "vendor-dir": "vendor/mylibs"），Composer 会卡住或报错，甚至删掉整个 vendor。

• 错误现象：Could not delete /path/to/vendor/composer 或 RecursiveDirectoryIterator 报错
• 根本原因：Composer 在清理旧 vendor 时，会递归删除整个目录，而新路径若在旧 vendor 内，就触发自相矛盾的删除逻辑
• 安全做法：新路径必须和原 vendor 平级（如 lib/vendor）或上级（如 ../shared/vendor），且不能是任何已存在 vendor 的子路径
• Windows 下还要留意路径分隔符，统一用正斜杠 / 或双反斜杠 ，避免因单反斜杠被解析为转义字符

改 vendor 路径本身很简单，难的是让所有上下游环节（Git、CI、ide、部署脚本、团队成员）都意识到这个路径变了。最容易漏的是 IDE 的自动索引和 PHPStan/ Psalm 的配置，它们可能还盯着默认 vendor 去找类定义。