不是必须，但几乎总是要实现；installerinterface 仅强制 supports() 和 isinstalled()，install()/uninstall() 可选，不实现则包不会被复制到目标位置，导致 vendor/ 下无目录且无报错。
Composer 自定义 Installer 必须实现 install() 和 uninstall() 吗？
不是必须，但几乎总是要实现。Composer 的 InstallerInterface 只强制要求 supports() 和 isInstalled()；install() 和 uninstall() 是可选的——但如果你不写，包就根本不会被复制到目标位置，等于没装。
常见错误现象：composer install 无声跳过你的包，vendor/your-vendor/your-package 目录不存在，也没有报错。
-
supports()返回true仅表示“我愿意处理这个包”，不等于“我已装好” -
isInstalled()被composer status和更新逻辑依赖，返回false会导致反复重装 - 真正干活的是
install()：它得手动把源文件copy或symlink到指定路径（比如public/themes/）
如何让 Composer 把包装到 public/themes/ 而不是 vendor/？
靠重写 getInstallPath()。这个方法决定包最终落脚点，路径必须是相对于项目根目录的相对路径，且不能以 / 开头。
使用场景：主题、插件、前端资源包等需要脱离 vendor 目录部署的类型。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 返回值示例：
return 'public/themes/' . $package->getPrettyName(); - 注意检查目标目录是否可写，否则
install()里Files::copy会静默失败（建议加if (!is_writable($targetDir)) { throw new \RuntimeException(...); }） - 别拼错路径名——
public/theme和public/themes混用会导致多套资源散落，后期清理困难
composer.json 里怎么声明自定义 Installer？
两处关键配置缺一不可：一是 type 字段设为自定义类型（如 drupal-theme），二是 require 中引入带 installer 的插件包，并确保其 autoload 能加载你的 Installer 类。
参数差异：type 不是随便起的字符串，它会传给 supports() 方法做判断依据；Installer 类必须通过 Composer 自动加载机制可用（通常放 src/ 下并配好 PSR-4）。
-
"type": "myapp-theme"→supports('myapp-theme')必须返回true -
"require": { "myorg/composer-installer": "^1.0" }，且该包的composer.json中需含"classmap": ["src/"]或正确psr-4 - 漏掉
classmap或命名空间不匹配，会导致Class not found错误，但 Composer 默认不报详细异常堆栈
为什么 composer update 时 Installer 不触发？
大概率是 supports() 返回了 false，或者包的 type 没匹配上。Composer 在执行前会逐个询问每个注册的 Installer：“你支持装这个包吗？”，只有返回 true 的才会进入后续流程。
性能影响：每个 Installer 的 supports() 都会被调用一次，如果逻辑太重（比如读文件、查数据库），会拖慢整个 update 过程。
- 调试技巧：在
supports()开头加file_put_contents('/tmp/debug.log', "$packageType\n", FILE_APPEND);看实际传入的 type - 常见坑：
package.type是小写的（如wordpress-plugin），但代码里写了WordPress-Plugin导致不匹配 - 另一个隐藏原因：你的 Installer 类没被正确注册——检查插件包的
extra.installer-types是否列出了你用的type，或是否用了旧版 Composer（
supports() 匹配失败 + 日志无声，建议第一步先打日志确认 type 值和调用时机。
