composer install 默认安装到 vendor 目录；修改 vendor-dir 仅在 vendor 不存在时生效，需删除 vendor 和 composer.lock 后重新 install 才生效，且需同步更新所有引用路径。
composer install 默认装到哪？改 vendor-dir 真的能“重命名” vendor 目录吗
不能靠改名或软链接“骗过” Composer，vendor-dir 配置只在 vendor 目录不存在时生效，不是运行时重定向开关。它本质是告诉 Composer：“下次从零安装时，把包写到这个路径”，而不是“把已有的 vendor 移过去”。
- 已存在
vendor目录时，改了composer.json里的"config": {"vendor-dir": "libs"}完全没用 - 必须先
rm -rf vendor composer.lock，再跑composer install，新路径才起作用 -
vendor/autoload.php路径会变——你代码里写的require 'vendor/autoload.php'得同步改成require 'libs/autoload.php' -
vendor/bin/xxx也会变成libs/bin/xxx，CI 脚本、Dockerfile、IDE 的 PATH 或外部调用都得跟着改
想让某个包（比如 WordPress 插件）不进 vendor，该用什么机制
Composer 本身不支持按包名指定路径，但支持按 type 分发——这是唯一官方认可、稳定可用的方式。核心是：插件声明自己的 type，你用 composer/installers 或自定义 Installer 拦截该类型。
- 第三方包必须自己设
"type": "wordpress-plugin"，你无法替它改；否则composer/installers根本不识别 - 项目根目录
composer.json加"extra": {"installer-paths": {"wp-content/plugins/{$name}": ["type:wordpress-plugin"]}}即可生效 - 通配只认
type:和vendor/name，不支持正则或模糊匹配，["acme/*"]可以，["*my-tool*"]不行 - 别用
post-install-cmd脚本移动文件——这会破坏composer.lock记录的路径、导致composer update误判为未安装而反复重装
写一个自定义 Installer 插件，为什么 activate() 里必须调 addInstaller()
因为 Composer v2 的插件生命周期里，activate() 是唯一能注册 Installer 实例的地方；漏掉 $installerManager->addInstaller()，你的类根本不会被调用，连 supports() 都不会执行——看起来“插件装上了”，实际完全静默。
- 你的 Installer 类必须继承
LibraryInstaller，并实现supports()、getInstallPath()、isInstalled() -
getInstallPath()返回值不能以/开头（否则抛InvalidArgumentException），且必须是相对项目根目录的路径，例如'packages/' . $package->getName() -
isInstalled()必须准确返回true当目录存在且含composer.json，否则composer update每次都认为包没装，强制重拉重解压 -
extra.class必须指向完整命名空间类名，且该类需在autoload中正确映射，否则插件加载失败无提示
bin-dir 改了，为什么 phpunit 还是找不到
因为 bin-dir 只控制二进制文件生成位置，不影响系统 PATH 或当前 shell 的命令查找路径。改完不加进环境变量，终端当然不认识新路径下的命令。
- 项目级配置：
"config": {"bin-dir": "scripts/tools"}→ 文件生成到scripts/tools/phpunit - 全局配置：
composer config --global bin-dir "/usr/local/bin"→ 所有没设本地bin-dir的项目都走这里 - Linux/macOS：在
~/.zshrc或~/.bash_profile加export PATH="scripts/tools:$PATH"，然后source一下 - Windows：需手动把新路径加进系统环境变量
PATH，CMD/PowerShell 才能直接敲phpunit - 注意：改
bin-dir不会自动迁移旧文件，必须重新composer install或composer update
真正难的从来不是改配置项，而是所有依赖路径的上下文是否同步更新——autoload 引入、脚本调用、IDE 索引、CI 流水线、甚至队友本地开发环境，只要漏掉一处，就卡在 Class not found 或 command not found 上。
