composer/installers插件必须安装且版本≥2.0，否则extra.installer-paths配置不生效；目标包需在自身composer.json中声明匹配的type字段，且须执行composer install（非update）并清空vendor和composer.lock后才能触发路径重定向。
composer/installers 插件必须先装，否则 extra.installer-paths 完全不生效
你写好了 extra.installer-paths 配置，但 composer install 后包还是进 vendor/——大概率是漏掉了这一步：composer require composer/installers。这个插件不是可选的，它是整个路径重定向机制的执行引擎。
注意版本要求：composer/installers 必须 ≥ 2.0；1.x 版本不支持现代 Composer 的 installer-paths 逻辑。运行以下命令确认：
composer show composer/installers
如果没装或版本太低，直接升级：
composer require composer/installers:^2.0 --no-updatecomposer update composer/installers
目标包的 type 字段必须匹配，普通 library 不会被重定向
installer-paths 不是“按包名移动”，而是“按 type 规则搬运”。比如你配置了 "wp-content/plugins/{$name}/": ["type:wordpress-plugin"]，那只有 type 真正为 wordpress-plugin 的包才会被挪走。
常见误区：
-
guzzlehttp/guzzle的type是library，它永远不会触发任何type:规则 -
wpackagist-plugin/akismet的type是wordpress-plugin，才符合条件 - 自定义包若想被识别，必须在自己
composer.json中显式声明"type": "my-custom-type"，然后你在主项目中配["type:my-custom-type"]
验证方式：运行 composer show vendor/package-name，看输出里 types 行是否匹配你的规则。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须清空 vendor 和 lock 文件后重装，增量更新不触发路径重排
改完 extra.installer-paths 并装好 composer/installers，别急着 composer update xxx——这条命令只会更新指定包，不会重新评估安装路径。它会原地覆盖旧文件，路径不变。
真正生效的操作只有两个：
-
rm -rf vendor composer.lock（Windows 用rd /s /q vendor && del composer.lock） -
composer install（不是update）
原因：路径分配发生在包解压前的“安装规划阶段”，而 update 默认复用已有锁文件中的路径记录，跳过重规划。
路径值不能以 / 开头，且 {$name} 是包名最后一段，不是完整名称
写路径时容易犯两个硬性错误：
- 路径以
/开头，例如"/wp-content/plugins/{$name}/"—— Composer 会静默忽略整条规则，不报错也不执行 - 误以为
{$name}是acme/my-plugin，实际它只取最后一段，即my-plugin；所以"wp-content/plugins/{$name}/"对应的是wp-content/plugins/my-plugin/，不是wp-content/plugins/acme-my-plugin/
路径必须相对于项目根目录。比如你想把插件装到 web/wp-content/plugins/，就写 "web/wp-content/plugins/{$name}/"，而不是 ../wp-content/plugins/{$name}/ 或绝对路径。
autoload 字段决定，Composer 不会为你重写它们的映射路径。如果你发现类找不到，问题不在 installer-paths，而在包自身 autoload 配置是否适配了新位置。
