Composer 在 Windows 上运行缓慢或报错,主因是杀毒软件实时扫描干扰临时文件、缓存及 ZIP 解压过程;应将 %APPDATA%\Composer、%LOCALAPPDATA%\Composer\files、项目 vendor 目录及 %TEMP%\composer* 加入杀软排除列表,而非关闭防护。

Composer 在 Windows 上运行缓慢或报错,很大概率是杀毒软件实时扫描干扰了大量临时文件、缓存目录和 ZIP 解压过程。关键思路是把 Composer 的核心路径加入杀毒软件的排除列表,而不是关掉防护。
明确需要排除的 Composer 目录
杀毒软件需要跳过以下几类路径,否则每次创建临时 ZIP、写入 vendor、读取 composer.lock 都可能被拦截或延迟:
-
Composer 全局数据目录:通常是
%APPDATA%\Composer(如C:\Users\用户名\AppData\Roaming\Composer) -
Composer 缓存目录:默认在
%LOCALAPPDATA%\Composer\files(如C:\Users\用户名\AppData\Local\Composer\files) -
项目中的 vendor 目录:每个项目的
vendor/文件夹(尤其是执行composer install或update时) -
系统临时目录中的 Composer 临时文件:如
%TEMP%\composer*或%TMP%\composer*(可临时用echo %TEMP%查看)
以 Windows Defender 为例添加排除项
Windows 自带的 Microsoft Defender 是最常见的干扰源。操作步骤如下:
- 打开「Windows 安全中心」→「病毒和威胁防护」→「管理设置」→「添加或删除排除项」
- 点击「添加排除项」→ 选择「文件夹」→ 依次添加上面列出的 Composer 目录
- 特别注意:
%LOCALAPPDATA%\Composer和%APPDATA%\Composer必须手动展开为完整路径再添加(Defender 不识别环境变量) - 添加后重启终端或重新运行 Composer 命令,效果通常立即可见
其他主流杀软的处理建议
不同软件界面不同,但逻辑一致:找「实时防护例外」、「排除路径」或「信任目录」设置入口:
- 火绒安全:设置 → 病毒查杀 → 实时防护 → 添加信任区(选文件夹)
- 360安全卫士 / 腾讯电脑管家:进入「木马查杀」或「防护中心」→ 找到「信任区」或「添加信任目录」功能
- 卡巴斯基:设置 → 防护 → 文件反病毒 → 排除项 → 添加文件夹并勾选「不扫描子文件夹中的档案」(避免 ZIP 逐文件扫描)
辅助优化建议(非必须但有效)
排除路径后若仍有卡顿,可配合以下调整进一步提升稳定性:
- 运行
composer config -g cache-dir "%LOCALAPPDATA%\Composer\cache"确保缓存路径明确且已排除 - 禁用 Composer 的 ZIP 解压回退机制:在全局配置中加
"disable-tls": true并不推荐;更稳妥的是确保 PHP 启用了zip扩展(检查php -m | findstr zip) - 避免在 OneDrive 或 Dropbox 同步文件夹内运行 Composer(云同步会叠加文件监控压力)
基本上就这些。不需要卸载杀软,也不用降低整体防护等级,精准排除几个目录就能让 Composer 回归正常速度。











