composer 提示 "git was not found, check that it is installed and in your PATH" 终极解决方案

先确认Git是否安装并配置到PATH中。若未安装，需下载Git并选择添加至PATH；已安装则检查环境变量是否包含Git路径，如C:\Program Files\Git\bin或/usr/bin/git；WSL用户应在子系统内安装Git；最后重启终端或IDE确保Composer可调用Git命令。

当你在使用 Composer 安装或更新 PHP 包时，遇到提示 "git was not found, check that it is installed and in your PATH"，说明系统无法找到 Git 命令。这个问题虽然常见，但只要一步步排查，就能彻底解决。以下是终极解决方案。

确认 Git 是否已安装

Composer 在拉取某些包（尤其是开发分支或私有仓库）时会调用 Git。如果 Git 没装或无法被识别，就会报错。

打开终端（Windows 是 CMD 或 PowerShell，macOS/Linux 是 Terminal），运行：

如果返回类似 git version 2.xx.x，说明 Git 已安装。如果提示“不是内部或外部命令”，则需要安装 Git。

安装 Git（如未安装）

• Windows：前往 https://www.php.cn/link/7ca2d2c04c0bb98f7b3481751387214a 下载并安装 Git。安装过程中建议选择“Add Git to PATH”选项（推荐使用默认安装设置）。
• macOS：可通过 Homebrew 安装：
  brew install git
• Linux（Ubuntu/Debian）：
  sudo apt update && sudo apt install git

检查 Git 是否在系统 PATH 中

即使安装了 Git，如果它不在环境变量 PATH 中，Composer 依然找不到。

运行以下命令查看 PATH：

查找是否包含 Git 的安装路径，例如：

• Windows 常见路径：C:\Program Files\Git\bin 或 C:\Program Files\Git\cmd
• macOS/Linux：通常为 /usr/bin/git 或通过 Homebrew 安装在 /opt/homebrew/bin

如果路径缺失，需手动添加。

AISEO

AI创作对SEO友好的文案和文章

56

查看详情

手动添加 Git 到 PATH（Windows 示例）

1. 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
2. 在“系统变量”中找到 Path，双击编辑
3. 添加以下两条路径（根据你的实际安装位置调整）：
   C:\Program Files\Git\bin
C:\Program Files\Git\cmd
4. 保存后，重启终端或重新登录系统

再次运行 git --version 测试是否生效。

验证 Composer 是否能调用 Git

关闭所有终端窗口，重新打开，执行：

如果不再出现 git 找不到的错误，说明问题已解决。

特殊情况处理

如果你使用的是 WSL（Windows Subsystem for Linux）：

• 确保在 WSL 内部安装 Git：sudo apt install git
• Composer 应该也在 WSL 环境中运行，不要混用 Windows 和 WSL 的路径

如果你使用 PhpStorm 或其他 IDE 内置终端报错，但外部终端正常，请重启 IDE —— 它可能没有读取最新的环境变量。

基本上就这些。只要 Git 装了、PATH 配对了、终端重启了，Composer 就不会再报这个错。不复杂，但容易忽略细节。

以上就是composer 提示 "git was not found, check that it is installed and in your PATH" 终极解决方案的详细内容，更多请关注php中文网其它相关文章！