Composer InstallerInterface 是 Composer 提供的用于接管包安装路径与流程的核心接口，必须在开发需安装到非 vendor/ 目录（如 WordPress 插件）或需执行自定义逻辑（生成配置、校验签名）的包时实现；它要求实现 supports()、isInstalled()、install()、update() 四个方法，并配合 composer.json 中 type 声明使用。
Composer InstallerInterface 是什么，哪些场景必须实现它
当你开发一个需要被 Composer 安装到特定目录（比如 wp-content/plugins、web/modules）、或需在安装/更新时执行自定义逻辑（如生成配置、复制资源、校验签名）的包时，InstallerInterface 就不是可选项——它是唯一能接管安装路径和流程的接口。
它不适用于普通库（如 monolog/monolog），只对“非标准安装位置”的包有意义，典型如 WordPress 插件、Drupal 模块、Laravel 的前端资源包等。
- Composer 默认只认
vendor/，所有自定义路径都靠实现InstallerInterface+ 自定义type驱动 - 必须同时在
composer.json中声明"type"（如"type": "wordpress-plugin"），否则 Composer 根本不会调用你的安装器 - 不能仅靠
install-path配置实现——那是composer/installers提供的简化方案，底层仍是基于InstallerInterface
如何正确实现 InstallerInterface 的四个核心方法
接口要求实现 supports()、isInstalled()、install()、update() 四个方法。最容易出错的是前两个的语义和调用时机：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
supports($packageType)：只判断包类型是否匹配，**不检查文件系统**；返回true表示“我负责这类包”，Composer 才会继续调用后续方法 -
isInstalled($package)：必须返回布尔值，且只能基于**目标路径是否存在有效文件**判断（例如检查$targetDir/index.php是否可读），不能依赖vendor/composer/installed.json -
install()和update()：两者逻辑通常一致，但update()必须先清理旧文件（否则可能残留废弃文件），再执行完整拷贝 - 所有路径操作必须用
IOInterface和Filesystem（来自composer-plugin-api），禁止直接用copy()或mkdir()
为什么 install() 里用 $io->write() 不输出，以及如何调试
Composer 在非交互模式（如 CI 环境或 --no-interaction）下会静默掉 $io->write()，导致你以为逻辑没执行。这不是 bug，是设计行为。
- 真正可靠的调试方式是写日志到临时文件：
file_put_contents(sys_get_temp_dir() . '/composer-installer-debug.log', print_r($package, true), FILE_APPEND); - 确保你的插件类被正确注册：在插件的
composer.json中声明"autoload": {"psr-4": {"MyVendor\Composer\": "src/"}}，并在PluginInterface::activate()中通过$composer->getInstallationManager()->addInstaller()注册实例 - 运行
composer install -vvv可看到完整的 installer 匹配链，确认你的supports()是否被调用 - 常见失败原因：类未自动加载、
type声明与supports()返回值不一致、install()抛出异常但没被捕获（Composer 会中止整个安装）
composer/installers 是怎么工作的，能否直接复用它的逻辑
composer/installers 本身就是一个实现了 InstallerInterface 的通用安装器，它通过预设的 type → path 映射表（如 "drupal-module" → "modules/{$name}"）完成路径计算，不涉及复杂业务逻辑。
- 你可以直接继承
BaseInstaller（它的基类），重写getLocations()方法添加新type，这是最轻量的定制方式 - 但如果你需要在安装前后做额外动作（如生成
.env、运行npm install），就不能只靠它——必须自己实现完整接口，并在install()中调用parent::install()后追加逻辑 - 注意版本兼容：
composer/installers ^2.0要求 Composer 2.x，而^1.9兼容 Composer 1.x；混用会导致Class not found错误
真正难的从来不是写那四个方法，而是理解 Composer 安装器的生命周期——它在 vendor/ 写入完成前运行，此时 autoload 还未生成，任何依赖当前项目自动加载的代码都会失败。
