如何解决 Composer 因本地 Git 配置问题导致的 "Failed to execute git clone" 错误？

该错误源于 Composer 调用系统 Git 时因配置不全或协议冲突导致克隆失败；需补全 Git 全局用户信息（user.name/user.email），并优先切换为 HTTPS 协议（如 composer config -g github-protocols https），再排查代理、SSL 或 Git 环境异常。

这个错误通常是因为 Composer 在尝试通过 Git 克隆包时，本地 Git 配置（尤其是用户信息或 SSH/HTTPS 行为）不完整或冲突导致的。核心问题不是 Composer 本身，而是它调用系统 git 命令时被拒绝或中断。

检查并补全 Git 用户信息

Git 要求至少配置 user.name 和 user.email 才能正常执行某些操作（尤其在某些 Git 版本或容器环境中）。即使只是克隆，部分 Git 配置策略也会强制校验。

• 运行 git config --global user.name "Your Name" 和 git config --global user.email "you@example.com"
• 若仅用于依赖安装（无需提交），名字和邮箱可随意填写，但不能为空
• 检查是否误设了局部仓库配置：进入项目目录，运行 git config --list --show-origin，确认没有冲突的 local/user.email

确认 Git 协议与网络访问权限匹配

Composer 默认优先使用 SSH（如 git@github.com:user/repo.git）或 HTTPS（如 https://github.com/user/repo.git）。如果本地 Git 配置了 SSH 但未配置密钥，或公司网络屏蔽了 SSH 端口（22），就会卡在 clone 阶段。

标签： composer git linux windows github 端口 ssl mac ai macos 环境变量 w