Composer依赖安装失败时，应依次执行：一、清除全局缓存；二、删除vendor与composer.lock重装；三、切换至官方源并禁用镜像；四、手动清理特定包Git缓存目录；五、调优Git超时与重试参数。
如果您在使用 Composer 安装或更新依赖时，因 Git 仓库分支检出失败导致命令中断，则可能是由于本地 Git 元数据损坏、远程分支不可达或 Composer 缓存中存在过期/冲突的包快照。以下是解决此问题的具体操作步骤：
一、清除 Composer 全局缓存
Composer 在下载包时会将压缩包和 VCS 元数据缓存在本地，若缓存中残留了不完整或校验失败的 Git 仓库快照，可能导致后续 checkout 失败。清除缓存可强制 Composer 重新获取原始源数据。
1、在终端中执行 composer clear-cache 命令。
2、等待输出显示 Clearing cache (cache-dir): ... OK 及对应路径信息。
3、确认缓存目录已清空，可通过 composer config --global cache-dir 查看当前缓存路径并手动检查该目录是否为空。
二、删除 vendor 目录与 composer.lock 文件
vendor 目录中可能包含已部分检出但状态异常的 Git 工作副本，而 composer.lock 记录了上一次成功解析的提交哈希；若两者不一致，Composer 会尝试复用损坏的本地 Git 仓库，从而触发 checkout 错误。
1、在项目根目录下执行 rm -rf vendor（Linux/macOS）或 rmdir /s vendor（Windows CMD）。
2、执行 rm composer.lock 或 del composer.lock 删除锁文件。
3、运行 composer install 以从头重建依赖树与 Git 检出环境。
三、禁用 Git 镜像并强制直连源仓库
某些镜像服务（如国内 Packagist 镜像）可能未及时同步远程分支或返回错误的 refs 信息，导致 Composer 获取到无效的 commit hash，进而使 git checkout 失败。切换为官方源可绕过镜像层干扰。
1、执行 composer config --global repo.packagist.org composer https://packagist.org 还原为官方源。
2、若此前配置过镜像，需同时移除自定义配置：运行 composer config --global --unset repos.packagist。
3、执行 composer update --no-cache 启动无缓存更新流程，避免复用旧镜像响应。
四、手动清理特定包的 Git 缓存目录
Composer 将每个 VCS 包的 Git 克隆副本单独存储于缓存目录下的 vcs/ 子目录中，若某包对应目录内 .git 文件损坏，即使全局缓存清除也无法修复该路径。需定位并删除具体包的缓存子目录。
1、运行 composer config --global cache-dir 获取缓存根路径。
2、进入该路径下的 vcs/ 目录，查找名称中包含目标包域名或仓库名的子目录（例如 github.com-somevendor-somepackage.git/）。
3、删除该子目录：rm -rf github.com-somevendor-somepackage.git（Linux/macOS）或使用资源管理器彻底删除（Windows）。
五、设置 Git 超时与重试参数
网络不稳定时，Git clone 或 fetch 过程可能被中断，导致 Composer 认为仓库初始化失败。通过增加超时阈值与启用自动重试，可提升检出成功率。
1、执行 git config --global http.postBuffer 524288000 扩大 HTTP 缓冲区至 500MB。
2、设置全局 Git 超时：运行 git config --global core.compression 9 和 git config --global http.lowSpeedLimit 0。
3、在 composer.json 的 config 段添加以下内容：
"process-timeout": 3600,
"use-include-path": false,
"preferred-install": {"*": "dist"}
