禁用 Composer 插件有五种方法：一、临时用 --no-plugins 参数；二、在 composer.json 的 extra.disabled-plugins 中指定包名；三、重命名 vendor 中插件目录为 .disabled 后缀；四、设置 COMPOSER_NO_PLUGINS=1 环境变量；五、手动删除插件目录并执行 dump-autoload。
如果您在 ThinkPHP 项目中遇到 Composer 插件引发的异常行为（如 install 卡住、autoload 冲突、配置被自动修改），需针对性禁用插件而非删除依赖。以下是禁用 Composer 插件的具体操作方法：
一、使用 --no-plugins 参数临时禁用全部插件
该方式强制 Composer 跳过所有插件加载与执行流程，包括 PluginInterface::activate()，适用于调试或 CI 构建等需纯净环境的场景。它不修改任何文件，仅对本次命令生效。
1、在终端中执行安装命令时，在末尾添加
--no-plugins
参数：
2、运行
composerinstall --no-plugins或composer update --no-plugins。
立即学习“PHP免费学习笔记（深入）
”；
3、确认参数位置正确：必须紧接在子命令（如 install）之后、其他选项之前，例如composer update --with-dependencies --no-plugins是安全写法，而composer update --no-plugins --with-dependencies在部分旧版本中可能被忽略。
二、通过 composer.json 的 disabled-plugins 精确禁用指定插件
此方法是 Composer ≥2.2 官方唯一支持按名称禁用插件的方式，仅影响后续 install/update 操作，不触发插件 activate()，且不会删除已安装代码。
1、打开项目根目录下的
composer.json文件。
2、在
extra字段内添加disabled-plugins数组，值为完整包名（vendor/name 格式，大小写敏感）：
3、示例配置：
"extra": { "disabled-plugins": [ "hirak/prestissimo", "phpstan/extension-installer" ] }
4、保存后执行
composer install或composer update，使配置生效。
三、临时重命名 vendor 中插件目录绕过加载
该方式不修改配置、不更新 lock 文件，直接阻止 Composer 扫描并实例化目标插件，适合快速验证某插件是否为故障源。
1、定位插件所在路径，例如
vendor/dealerdirect/phpcodesniffer-composer-installer。
PHP 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
2、将其重命名为带
.disabled后缀的目录名，如vendor/dealerdirect/phpcodesniffer-composer-installer.disabled。
3、执行
composer dump-autoload清除 autoload 缓存，避免旧类仍被加载。
4、调试完成后，将目录名改回原样即可恢复，无需重新 install。
四、设置 COMPOSER_NO_PLUGINS=1 环境变量全局禁用
该变量效果等同于命令行添加 --no-plugins，但作用于当前 shell 会话及所有子进程，适用于 CI 脚本统一控制，不依赖参数传递顺序。
1、Linux/macOS 下执行：COMPOSER_NO_PLUGINS=1 composer install。
2、Windows cmd 下执行：set COMPOSER_NO_PLUGINS=1 && composer install。
3、Windows PowerShell 下执行：$env:COMPOSER_NO_PLUGINS="1"; composer install。
4、注意：该变量比 COMPOSER_DISABLE_PLUGINS=1 更彻底，会跳过插件发现、实例化及 activate 全流程，且不依赖插件自身逻辑响应。
五、手动删除 vendor 中插件目录并刷新 autoload
当插件非硬依赖（未被其他包 require），且需彻底移除其代码与 autoload 条目时，此方法最干净，可避免类重复声明或冲突。
1、进入
vendor/目录，找到对应插件文件夹，例如vendor/myclabs/deep-copy。
2、执行
rm -rf vendor/myclabs/deep-copy（Linux/macOS）或手动删除（Windows）。
3、运行
composer dump-autoload更新自动加载映射。
4、若该插件被其他包硬依赖，执行
composer install将报错，此时需从源头移除 require 声明。