挂载 vendor 目录是 docker/vm 中最常见 i/o 源头，因文件系统桥接导致 macos/windows 上 stat/open/read 延迟飙升，易触发超时或“no space left on device”错误；应禁用实时挂载，改用命名卷或 rsync 同步，并将 composer 缓存移至 ssd 或 tmpfs 以规避低速存储瓶颈。
挂载 vendor 目录是 Docker/VM 中最常见 I/O 源头
在 Docker 容器或虚拟机里把 vendor/ 直接挂载成宿主机目录（比如 -v $(pwd)/vendor:/app/vendor），会导致所有文件读写都经过文件系统桥接层——macOS 和 Windows 上尤其明显，stat()、open()、read() 等调用延迟飙升，Composer 解压几百个小 ZIP 包时极易触发超时或 “No space left on device” 报错，哪怕磁盘还有空间。
实操建议：
- 开发中禁用
vendor/挂载，改用命名卷：docker run -v $(pwd):/app -v composer-vendor:/app/vendor image composer install - CI 或部署脚本中，确保
composer install在容器内执行，而非宿主机生成后拷贝进容器 - 若必须同步 vendor，用
rsync -av --delete vendor/ container:/app/vendor替代实时挂载
磁盘缓存路径落在低速设备上会拖慢整个流程
Composer 默认把下载的 ZIP 包、解压源码、HTTP 响应缓存全存在 ~/.composer/cache/（Linux/macOS）或 %APPDATA%\Composer\Cache\（Windows）。如果这个路径在机械硬盘、网络存储或 Docker 的默认 overlay2 文件系统上，解包前的校验和提取阶段就会卡住——你看到的 “Extracting archive” 耗时 30 秒以上，大概率是这里。
实操建议：
- 查当前缓存位置：
composer config -g cache-dir - 迁移到 SSD 或内存盘：
composer config -g cache-dir /mnt/ssd/composer-cache - 临时用 tmpfs（Linux）：
sudo mount -t tmpfs -o size=2G tmpfs /mnt/ramdisk，再设为 cache-dir - 注意：不要设成
/tmp，某些系统会定期清理 tmp 下内容，导致缓存反复重建
报错 “No space left on device” 很可能不是磁盘满，而是 inode 耗尽
Composer 缓存里每个包版本都建独立子目录（如 ~/.composer/cache/files/monolog/monolog/1.27.0/），全是小文件。长期不清理，df -i 显示 inode Use% 100%，哪怕 df -h 还剩 20GB，也会在下载阶段直接失败，错误日志却只显示 “failed to open stream” 或 “Unable to create directory”。
实操建议：
- 先跑
df -i，重点看缓存所在分区；Windows 用户检查%APPDATA%\Composer\Cache\下文件总数 - 停掉所有 Composer 进程：
pgrep -f composer | xargs kill -9（Linux/macOS）或任务管理器结束php.exe相关进程（Windows） - 再执行
composer clear-cache—— 它会安全校验并删除，比手动rm -rf可靠得多 - 预防：配置
cache-files-ttl 0和cache-files-maxsize 0，禁用 ZIP 包缓存
--prefer-dist 不只是“快一点”，它绕过了最耗 I/O 的 Git 克隆环节
Composer 默认策略是：如果包有 Git 仓库且没被标记为 “dist-only”，就优先 clone 仓库而非下载 ZIP。Git 克隆要建 .git 目录、解 packfile、checkout 多次，I/O 密集度远高于解一个 ZIP。尤其在 CI 环境或 Windows 上，git clone 经常因权限、行尾符或长路径失败，错误信息却藏在 verbose 日志深处。
实操建议：
- 强制走 dist 流程：
composer install --prefer-dist - 生产部署加三件套：
composer install --no-dev --prefer-dist --optimize-autoloader - 全局设为默认：
composer config -g prefer-dist true，避免每次敲参数 - 注意：私有 Git 仓库需在
composer.json中显式声明"type": "package"并提供 dist URL，否则--prefer-dist无效
clear-cache 前忘了杀掉 IDE 里后台运行的 Composer 进程。
