composer如何解决 “Failed to execute git clone” 错误-composer-PHP中文网

composer如何解决 “Failed to execute git clone” 错误

下次还敢

发布： 2025-10-16 14:13:01

原创

690人浏览过

答案：Failed to execute git clone 错误通常由 Git 未安装、网络问题或 SSH 权限引起，需检查 Git 配置、网络连接及认证方式。1. 确保系统已安装并正确配置 Git，可通过 git --version 验证；2. 检查网络是否屏蔽 GitHub，尝试手动克隆或使用代理及镜像地址；3. 若使用 SSH 地址，需配置 SSH 密钥并添加公钥至对应账户，或强制使用 HTTPS 协议；4. 清除 Composer 缓存并删除 vendor 和 composer.lock 后重试安装。

composer如何解决 “failed to execute git clone” 错误

出现 “Failed to execute git clone” 错误通常是因为 Composer 在尝试从 Git 仓库拉取依赖包时无法执行克隆操作。这个问题可能由多种原因引起，下面列出常见原因及对应的解决方法。

检查 Git 是否已安装并配置正确

Composer 依赖系统中的 Git 命令来克隆仓库。如果 Git 未安装或不可用，就会报错。

• 确保已在系统中安装 Git：在终端运行 git --version 查看是否返回版本号。
• 若未安装，请前往 https://www.php.cn/link/81b69a02d9469be08c2426117991d9f0 下载并安装对应系统的 Git。
• 安装后确保 Git 可在命令行全局使用（将路径加入环境变量）。

网络问题或防火墙限制

某些网络环境（如公司内网、国内网络）可能无法直接访问 GitHub 或其他 Git 服务器。

• 尝试手动执行 git clone 命令，例如：
git clone https://github.com/symfony/http-foundation.git
看是否能成功。
• 如果失败，可能是网络被屏蔽。可尝试：
- 使用代理：
git config --global http.proxy http://proxy.example.com:port
- 对于 GitHub，可临时改用镜像地址（如 gitee 镜像）或切换为 HTTPS 协议。

SSH 权限问题

如果 Composer 依赖使用了 SSH 地址（如 git@github.com:vendor/package.git），而你没有配置 SSH 密钥，也会失败。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

• 检查是否提示权限拒绝（Permission denied, publickey）。
• 解决方法：
- 生成 SSH 密钥：ssh-keygen -t ed25519 -C "your_email@example.com"
- 将公钥（~/.ssh/id_ed25519.pub）添加到 GitHub/GitLab 账户。
- 测试连接：ssh -T git@github.com
• 或者让 Composer 强制使用 HTTPS：
composer config --global github-protocols https