--no-plugins 参数指示 Composer 在执行命令时不加载任何插件，用于排除插件对依赖解析、网络请求或脚本执行的干扰。该参数适用于诊断依赖安装失败、版本解析异常、镜像源替换、脚本出错或包下载校验等问题。通过对比启用与禁用插件时的行为差异，可判断问题是否由插件引起。典型诊断命令为：composer update --dry-run --no-plugins，可结合 --no-scripts、--no-cache 和 -vvv 等参数增强排查效果。注意 --no-plugins 不影响核心配置读取，但可能阻碍私有库访问，故建议仅在调试阶段于安全环境中使用。

当使用 Composer 安装或更新依赖时，某些全局或项目级插件可能会影响行为，比如修改下载源、拦截事件钩子或改变包解析逻辑。这些插件虽然在日常开发中有用，但在排查依赖问题时可能引入干扰。为了进行“纯净”的依赖分析，Composer 提供了 --no-plugins 参数，可以临时禁用所有插件，确保诊断过程不受外部扩展影响。

什么是 --no-plugins 参数？

该参数指示 Composer 在执行当前命令时不加载任何插件，包括通过 composer.json 声明的本地插件和全局安装的插件。这能确保命令运行环境尽可能接近“原生”状态，排除插件对依赖解析、网络请求或脚本执行的干预。

在哪些场景下使用 --no-plugins 进行诊断？

当你遇到以下问题时，建议使用 --no-plugins 来确认是否由插件引起：

• 依赖安装失败或版本解析异常
• 镜像源被意外替换或请求超时
• post-install-cmd 脚本执行出错
• 某些包无法正常下载或校验失败

通过对比启用和禁用插件时的行为差异，可快速定位问题根源。

如何实际操作进行纯净诊断？

以常见的依赖冲突为例，你可以这样使用 --no-plugins：

这个命令会模拟更新流程，但不执行实际写入，并且跳过所有插件。如果此时不再报错，说明原问题很可能来自某个插件。

你也可以结合其他诊断参数增强效果：

• --no-scripts：同时禁用自定义脚本
• --no-cache：避免缓存干扰（注意这不是独立参数）
• -v 或 -vvv：增加输出详细程度

例如完整诊断命令：

注意事项与局限性

--no-plugins 不会影响 require、autoload 等核心配置的读取，它只屏蔽插件类的功能注入。另外，部分企业级工具链依赖插件完成认证或私库访问，禁用后可能导致无法拉取私有包。因此建议仅在调试阶段使用，并在安全环境中测试。

基本上就这些。用好 --no-plugins 能帮你剥离干扰，看清 Composer 的真实依赖决策过程，是排查复杂依赖问题的实用手段。