首先确认系统是否安装并配置了Git工具。Windows用户需安装Git for Windows并添加到PATH,macOS可通过Homebrew执行brew install git,Linux用户使用apt或yum安装。安装后运行git --version验证。若仍报错,检查系统PATH环境变量是否包含Git的cmd路径(如C:\Program Files\Git\cmd)。临时解决方案是设置composer config -g preferred-install dist以跳过Git克隆,但推荐彻底解决Git环境问题。完成配置后,Composer即可正常拉取依赖。

在使用 Composer 更新项目依赖时,如果遇到提示 git 命令未找到(如 "The git command is not available" 或 "sh: git: command not found"),说明系统环境缺少 Git 工具或未正确配置。Composer 在安装某些包(尤其是从 GitHub 等源拉取开发版本)时,会依赖 Git 来克隆代码库。以下是解决该问题的步骤。
安装 Git 工具
确保你的系统已安装 Git:
- Windows:下载并安装 Git for Windows,安装过程中选择“Add to PATH”选项,以便在命令行中全局使用 git 命令。
-
macOS:可通过 Homebrew 安装:
brew install git
或从官网下载安装包:https://www.php.cn/link/5f2397a240ce3565d4d3b82b0db2fc65 -
Linux(Ubuntu/Debian):
sudo apt update && sudo apt install git -
Linux(CentOS/RHEL):
sudo yum install git 或 sudo dnf install git(较新版本)
验证 Git 是否安装成功
打开终端或命令行工具,运行:
git --version如果返回类似 git version 2.xx.x 的信息,说明 Git 安装成功且可被识别。
将 Git 添加到系统 PATH(常见于 Windows)
若已安装 Git 但仍提示命令未找到,可能是环境变量 PATH 未包含 Git 可执行文件路径。
- 找到 Git 安装路径下的
cmd目录,例如:C:\Program Files\Git\cmd - 将此路径添加到系统的 PATH 环境变量中
- 重启终端或 IDE,再次运行 Composer 命令测试
临时绕过 Git(不推荐长期使用)
如果你暂时无法安装 Git,可让 Composer 使用 HTTP 直接下载压缩包代替 Git 克隆:
composer config -g preferred-install dist这会优先使用预打包的 release 版本,避免调用 Git。但部分开发分支或私有仓库仍可能失败。
基本上就这些。安装并正确配置 Git 后,Composer 就能正常拉取需要的源码依赖了。问题通常出在环境缺失或 PATH 配置不完整,检查清楚即可解决。










