Plugin was skipped警告出现是因为Composer 2.2+默认跳过未在项目根composer.json中显式require或require-dev声明的插件,以提升安全性;需检查插件是否直接声明、autoload配置是否正确,或临时禁用plugin-discovery(不推荐)。

为什么Plugin was skipped警告总在更新时出现
这个警告其实不算错误,但它明确告诉你:Composer没有加载你项目中声明的那些插件。无论是composer/installers、phpstan/extension-installer还是你自定义的插件,只要没满足启用条件,就会被“跳过”。那么,最常见的原因是什么?
问题往往出在插件包的依赖声明上。如果插件只是出现在项目的extra配置里,或者通过其他依赖包被间接引入,而没有被项目根目录的composer.json在require或require-dev中显式声明——那么,从Composer 2.2+版本开始,这类“未直接依赖”的插件就会被默认跳过。这可不是Bug,而是Composer为了提升安全性和行为可预测性特意引入的机制。
检查插件是否被正确 require 到当前项目
第一步,先摸清家底。运行composer show --plugins命令,看看当前已经激活的插件列表里有没有你的目标。如果不在其中,那大概率就是它“寄人篱下”——只存在于某个依赖包的composer.json里,而不是在你项目自己的声明中。
接下来,对症下药:
- 打开项目根目录的
composer.json文件,仔细核对。像dealerdirect/phpcodesniffer-composer-installer这类插件包,必须白纸黑字地出现在require或require-dev字段里才行。 - 如果插件只是被某个依赖包“顺带”安装进来的,比如A包require了B插件,但你的项目并没有直接require B,那么B插件就会被无情跳过。这时候,唯一的办法就是手动把它加进去:
"require-dev": { "phpstan/extension-installer": "^1.3" } - 添加声明后,建议执行针对性的更新命令,例如
composer update phpstan/extension-installer,而不是全量update,这样可以避免意外升级其他不相干的包。
插件类名或 autoload 配置不匹配导致跳过
别以为正确require了就万事大吉。有时候,Composer即使找到了插件包,也可能因为无法实例化插件类而选择跳过。典型的迹象是,警告信息末尾会附带一句类似Class “SomePlugin” not found的提示。
这时候,你需要排查以下几个环节:
- 检查插件包自身的
composer.json配置,看看autoload和extra.installer-paths(如果适用)的设置是否正确。 - 确认插件的主类文件路径,是否与
autoload中配置的PSR-4命名空间映射完全一致。举个例子:"autoload": { "psr-4": { "PhpStan\\ExtensionInstaller\\": "src/" } }这个配置,就应该对应一个类似PhpStanExtensionInstallerInstaller的类名。 - 完成检查后,可以运行
composer dump-autoload -o命令,强制刷新自动加载映射,然后再重新执行install或update试试。
禁用插件跳过机制(仅限可信环境)
当然,也存在一些极端情况。比如,你完全信任项目中的所有依赖,并且需要兼容旧有的工作流程,那么可以考虑临时关闭这个插件跳过逻辑。但必须强调,这会削弱Composer默认的安全屏障,通常不建议作为长期解决方案。
如果你确定要这么做,可以按以下步骤操作:
- 在项目根目录执行命令:
composer config plugin-discovery false
这会将config.plugin-discovery设置为false并写入你的composer.json。 - 需要警惕的是,这个配置是全局性的,对子依赖中的插件也同样生效,可能会引发一些不可预期的副作用,例如多个插件争抢处理同一事件。
- 在CI/CD等自动化构建环境中尤其要避免使用此方法,因为不同机器上的依赖解析顺序可能存在差异,导致构建行为不一致。
说到底,最稳定、最根本的解决之道,永远是“显式声明”加上“正确配置autoload”。那个Plugin was skipped警告,本质上就是Composer在向你发出友好提醒:“这个扩展我没敢动——因为你没明确说要它。” 理解并遵循这个设计初衷,问题自然迎刃而解。
