首先确认插件是否被正确加载，检查插件composer.json的type是否为composer-plugin，确保已通过require安装并运行composer install；接着查看installed.json中是否存在该插件，验证插件类是否实现PluginInterface并具备activate方法；然后开启-vvv调试模式，观察日志中是否有“Loading plugin”相关输出，确认插件是否被执行；若无加载信息，需排查自动加载配置，检查autoload路径与命名空间是否匹配，并执行composer dump-autoload更新映射；最后审查activate方法中是否正确注册事件监听器，事件名称是否准确，回调逻辑是否符合预期，确保事件触发条件与命令匹配。

当使用 Composer 插件时，如果发现插件功能没有按预期生效，可能是加载失败、配置错误或执行时机问题。以下是系统性的排查方法，帮助你快速定位并解决 Composer 插件不生效的问题。

确认插件是否被正确加载

Composer 在安装包时会根据 composer.json 中的 type 和 autoload 配置决定是否加载插件。

• 确保插件包的 composer.json 中 type 字段为 composer-plugin
• 检查主项目中已通过 require 安装了该插件，并运行过 composer install 或 composer update
• 查看插件是否在 vendor/composer/installed.json 中列出
• 确认插件类实现了 Composer\Plugin\PluginInterface，并且有正确的 activate() 方法

启用 Composer 调试模式查看加载过程

通过开启调试输出，可以观察 Composer 是否尝试加载插件。

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

• 运行命令时加上 -vvv 参数（如 composer install -vvv），查看详细日志
• 在日志中搜索插件类名或包名，确认是否有“Loading plugin”相关输出
• 若未出现加载信息，说明 Composer 根本没有识别到该插件
• 可临时在插件的 activate() 方法中添加 var_dump() 或写日志，验证是否被执行

检查插件事件监听和执行逻辑

插件通常通过监听 Composer 事件（如 post-install-cmd）来执行操作。

• 确认插件在 activate() 中正确注册了事件监听器（通过 $composer->getEventDispatcher()->addListener()）
• 检查监听的事件名称是否正确，例如应使用 ScriptEvents::POST_AUTOLOAD_DUMP 而非拼写错误的字符串
• 确保插件绑定的回调函数实际执行了期望的操作，比如修改文件、输出提示等
• 某些事件只在特定命令下触发，例如 post-update-cmd 不会在 install 时运行

验证自动加载与命名空间

即使插件结构正确，自动加载失败也会导致类无法实例化。

• 检查插件的 composer.json 中 autoload 配置是否包含插件类的路径
• 运行 composer dump-autoload 确保自动加载映射已更新
• 可在插件入口文件加调试语句，确认文件是否被包含
• 命名空间和文件路径需匹配，避免因大小写或路径错误导致类找不到

基本上就这些。Composer 插件不生效多数是加载链路中断所致，从包类型、自动加载、事件绑定三方面逐步验证，基本能定位问题所在。