Composer install 频繁超时多因磁盘 I/O 瓶颈，可依序采用：一、加 --prefer-dist 减少小文件写入；二、Docker/VM 中禁用 vendor 挂载；三、启用 APCu 加速 autoload；四、将 cache-dir 迁至 SSD 或内存盘；五、用 --no-scripts 分离耗时脚本。
如果您在执行 composer install 时频繁遭遇超时错误，且已排除网络与镜像问题，则很可能是磁盘 I/O 性能瓶颈所致——尤其在 Windows、Docker 挂载卷、虚拟机或机械硬盘环境下，大量小文件解压与写入操作极易拖慢进程。以下是针对性解决此问题的多种方法：
一、强制使用压缩包安装（--prefer-dist）
Composer 默认在满足条件时会优先克隆 Git 仓库（耗时高、I/O 密集），而 --prefer-dist 参数可绕过 Git 操作，直接下载预构建的 ZIP/TAR 包，显著减少磁盘读写次数和文件数量。
1、在项目根目录下执行安装命令并显式指定参数：
composer install --prefer-dist
2、如需同时优化自动加载，追加 --optimize-autoloader：
composer install --prefer-dist --optimize-autoloader
3、生产环境部署时建议固定组合：
composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative
二、禁用 vendor 目录挂载（Docker/VM 场景）
在 Docker 容器或虚拟机中，若将 vendor/ 目录挂载为宿主机共享卷，文件系统层转发会导致 I/O 延迟激增，甚至引发超时。应避免在运行 Composer 时挂载该目录，改为在容器内本地生成后再同步。
1、修改 docker-compose.yml 或 Dockerfile，移除对 vendor/ 的 volumes 映射
2、确保 composer install 在容器内部执行，而非宿主机上运行后拷贝进容器
3、若必须复用 vendor，改用 rsync -av --delete 或 tar -cf - vendor/ | docker exec -i container tar -xf - 等高效同步方式替代实时挂载
三、启用 APCu 加速自动加载（PHP 运行时优化）
虽然不直接加速安装过程，但 composer dump-autoload --apcu 可在后续脚本执行阶段大幅降低文件扫描开销；更重要的是，APCu 缓存本身依赖内存而非磁盘，能间接缓解因 autoload 机制反复触发 I/O 所致的卡顿假象。
1、确认 PHP 已启用 apcu 扩展：
php -m | grep apcu
2、生成权威类映射并启用 APCu 缓存：
composer dump-autoload --classmap-authoritative --apcu
3、验证是否生效：
php -r "var_dump(apcu_fetch('composer-autoload'));"
四、更换缓存存储路径至高速介质
Composer 默认缓存（cache-dir）若位于低速磁盘（如 HDD 或网络存储），会拖慢包解压前的校验与提取流程。将其迁移至 SSD 或 tmpfs 内存盘，可成倍提升 I/O 吞吐。
1、查看当前缓存路径：
composer config --list | grep cache-dir
2、创建本地 SSD 路径（例如 Linux 下）：
mkdir -p /mnt/ssd/composer-cache
3、全局重定向缓存位置：
composer config -g cache-dir /mnt/ssd/composer-cache
4、Windows 用户可设为本地 NVMe 盘路径，如：
composer config -g cache-dir D:\composer-cache
五、跳过安装后脚本以隔离 I/O 压力
post-install-cmd 中常包含 artisan config:cache、npm run dev 等磁盘密集型操作，这些并非 Composer 核心职责，却可能因 I/O 阻塞导致整体超时。先完成依赖安装，再单独执行脚本，可明确区分瓶颈环节。
1、执行无脚本安装：
composer install --no-scripts --no-plugins
2、手动运行关键初始化命令（避免并发写入冲突）：
php artisan config:cache && php artisan event:cache
3、若需前端资源构建，改用独立步骤：
npm ci && npm run production
