Composer怎么自定义安装路径_Installer配置教程【详解】

先确认是否已安装composer/installers且版本≥2.0，再检查目标包type是否为installer支持的类型（如wordpress-plugin），最后删除vendor和composer.lock重新install——installer-paths仅对新装或更新的特定type包生效，不重排已有包。

配置明明写好了，包却还是老老实实待在vendor目录下？别急着怀疑语法，多半是环境没到位。

composer.json 里配 installer-paths 没生效？先检查这三件事

最常见的“配置写了但包还在 vendor/ 下”现象，基本不是语法错，而是环境没到位。 - 确保项目已经安装了composer/installers。这步没做的话，extra.installer-paths写得再漂亮也是白搭。 - 运行composer show composer/installers看看输出信息，确认该包是否加载成功，版本建议≥ 2.0。如果输出里没有，说明它没被加载进当前作用域——比如你把它装在了require-dev里，却用install --no-dev跑生产环境，那它自然不会被考虑。 - 删掉整个vendor目录和composer.lock，再跑composer install。记住，installer-paths不会重排已安装的包，只对新安装或更新才会生效。

installer-paths 只对特定 type 的包起作用

它可不是全局搬家工具，而是给WordPress插件、Drupal模块这类有明确生态规范的包“开后门”的机制。普通PHP库（type: library）压根不走这条路。 - 想让wpackagist-plugin/akismet装进wp-content/plugins/akismet/，前提是它的composer.json里声明了"type": "wordpress-plugin"。 - 你自己的包如果想被接管，也得在它的composer.json中写明对应type，比如"type": "wordpress-theme"。 - 配置示例中"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]的{$name}是占位符，会被替换成包名最后一段（acme/my-plugin → my-plugin），路径必须以/结尾且不能以/开头。

config.vendor-dir 和 installer-paths 别混用

前者改的是整个vendor目录位置（所有包统一挪窝），后者只定向移动特定type的包（比如只动插件，不动monolog）。两者逻辑完全不同，强行叠加容易出问题。 - 改vendor-dir必须删掉旧vendor，再跑composer install；dump-autoload不够用，它不重建入口文件也不挪目录。 - vendor-dir改了之后，所有代码里的require 'vendor/autoload.php'得手动改成新路径，比如require 'third-party/autoload.php'。 - bin-dir必须同步配，否则vendor/bin/phpunit这类命令会失效；正确写法是："bin-dir": "third-party/bin"。

为什么 COMPOSER_VENDOR_DIR 环境变量有时不生效？

它只在项目composer.json里**没声明** config.vendor-dir时才起作用。一旦配置文件里写了，环境变量就被无视了——这是优先级陷阱，很多人在CI脚本里踩坑。 - Linux/macOS：临时生效可COMPOSER_VENDOR_DIR="deps" composer install。 - Windows PowerShell：$env:COMPOSER_VENDOR_DIR="deps"; composer install。 - 但注意：环境变量改了路径，autoload.php引用、IDE索引、CI脚本里的vendor/bin/xxx调用，全都得手动同步改，否则运行时照样报错。 真正难的从来不是加几行配置，而是确保autoload、bin、IDE、部署脚本、甚至某些框架内部硬编码的路径全部跟上变动。漏掉任意一环，Class not found或command not found就会立刻出现。