--no-plugins 用于禁用当前命令的所有插件,适用于调试插件干扰、确保纯净操作等场景;只需在命令末尾添加该选项,如 composer install --no-plugins,且仅对本次执行生效。

在 Composer 中,使用 --no-plugins 选项可以明确禁止所有插件在当前命令中加载和执行。
什么时候需要禁用插件
某些插件可能影响命令行为(如自动修改依赖、拦截安装流程、触发额外脚本),导致调试困难或意外失败。禁用插件有助于确认问题是否由插件引起,或在受控环境中确保纯净操作。
如何使用 --no-plugins
只需在任意 Composer 命令末尾添加 --no-plugins 即可:
composer install --no-pluginscomposer update --no-pluginscomposer dump-autoload --no-plugins
注意点和常见情况
禁用插件后,依赖中声明的插件不会被加载,但插件本身仍保留在 vendor/ 目录中,也不会被删除。
部分插件功能(如 hirak/prestissimo 的并行下载)被禁用后,命令会回退到默认行为(如串行下载)。
该选项仅对当前命令生效,不影响全局配置或后续命令。
替代方案:临时跳过特定插件
如果只想禁用某几个插件而非全部,Composer 本身不支持按名称排除,但你可以:
- 临时注释掉
composer.json中的"extra": {"installer-paths"}或插件相关配置 - 移除
vendor/bin下对应插件的二进制文件(不推荐,易出错) - 使用
COMPOSER_NO_PLUGINS=1环境变量替代命令行参数(效果等同)
基本上就这些。--no-plugins 是个简单但有效的排查和隔离手段。










