Windows 上 composer install 特别慢的根本原因是 NTFS 文件系统处理大量小文件效率低,叠加 Git 行尾转换、Defender 实时扫描及 PHP 配置不当;禁用 git clone 改用 zip、排除 Defender 扫描目录、启用 opcache 可将耗时从 3 分钟降至 20 秒内。
composer
install 为什么在 Windows 上特别慢
根本原因是 Windows 的文件系统(NTFS)对大量小文件的读写效率低,加上 Composer 默认启用的
和
操作会触发大量磁盘 I/O,而 PHP 的
在 Windows 下启动子进程开销也比 Linux 高得多。更关键的是,Windows 版 Git for Windows 默认启用
,导致每次检出都做行尾转换,拖慢依赖解包。
禁用 git clone 改用 zip 包安装
Composer 默认优先走
(尤其对 dev 分支),但在 Windows 上这一步最卡。强制它走 zip 包能跳过 Git 开销,提速 3–5 倍。
全局设置:
+
项目级覆盖(推荐):在
里加
注意:部分私有仓库或含 post-install-cmd 的包可能不兼容 zip 模式,遇到
就得关掉
关闭 Windows Defender 实时扫描临时目录
Composer 解压、生成 autoload 文件、写 vendor 目录时,Defender 会逐个扫描每个 .php 文件——这是 Windows 下最隐蔽的性能杀手。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。
下载
把
和项目根目录加入 Defender 排除列表(路径需具体到完整盘符,如
)
检查是否生效:运行
,看日志里
阶段耗时是否从分钟级降到秒级
别只排除
:Defender 对
的扫描同样致命
PHP 配置和运行环境微调
默认的 Windows PHP(尤其 XAMPP/WAMP 自带版本)常启用了过多 Xdebug 或 opcache 关闭,直接拖累 Composer 自身运行速度。
确认
中
且
(不是注释掉,是明确设为 off)
用
和
验证
避免在 WSL2 里跑 Windows 的 composer —— 跨文件系统调用 NTFS 会更慢;真要用 WSL,就整个项目放
下,用 WSL 自带的 PHP + Composer
真正卡住的从来不是网络,而是本地 I/O 和防病毒软件的“热心帮忙”。关掉 Defender 扫描、切 zip 安装、确保 opcache 开着,这三步做完,
从 3 分钟掉到 20 秒内是常态。但要注意:私有 GitLab 仓库若没开启 zip download 功能,
会直接失败,得单独处理。
git cloneunzipproc_opencore.autocrlf=truegit clonecomposer config -g prefer-stable truecomposer config -g use-zip truecomposer.json"config": {"use-zip": true}Failed to download ... No zip archive found%TEMP%C:\myprojectcomposer install -vvvExtracting...vendor/%TEMP%\composer_archive*php.iniopcache.enable=1xdebug.mode=offphp -m | findstr opcachephp -m | findstr xdebug/home/xxx/composer installuse-zip