如何解决 npm 安装中的“git is not installed or not in the PATH”错误？

npm 安装失败："git is not installed or not in the PATH" 错误指南

问题简介

在使用 npm 安装依赖项时，你可能会遇到以下错误：

git is not installed or not in the PATH

这个错误表明你的系统中未安装 Git 或 Git 未添加到 PATH 环境变量中。

原因

Git 是一个版本控制系统，用于从远程存储库（如 GitHub）克隆或更新代码。如果 Git 未安装或未添加到 PATH 中，npm 就无法从存储库中下载依赖项。

解决方法

1. 安装 Git

• 如果你的系统中尚未安装 Git，请从官方网站下载并安装适用于你的操作系统的最新版本。
• 安装完成后，在命令提示符或终端中输入 git --version 来验证安装是否成功。

2. 添加 Git 到 PATH

• 在 Windows 上：
  • 右键单击“此电脑”，选择“属性”，然后点击“高级系统设置”。
  • 在“高级”选项卡中，点击“环境变量”按钮。
  • 在“系统变量”中，找到“Path”变量，然后点击“编辑”。
  • 在“变量值”字段的末尾添加以下路径（如果尚未存在）：

;C:\Program Files\Git\bin

• 在 macOS 或 Linux 上：
  • 在终端中输入以下命令：

export PATH=$PATH:/usr/local/bin

3. 重启命令提示符或终端窗口

• 完成上述步骤后，你需要重启命令提示符或终端窗口以使更改生效。
• 重新运行 npm install 命令，错误应该会消失。

额外提示

• 如果你仍然遇到问题，请尝试使用完整的路径调用 Git 命令，例如：

C:\Program Files\Git\bin\git --version

• 你还可以显式指定 Git 可执行文件，例如：

npm install --global --prefix=~/.npm-global-prefix --cache-min=999999999 --fetch-retry-mintimeout=1000 --fetch-retry-maxtimeout=10000 --add-flag=--git-dir=C:/Program%20Files/Git/mingw64/share/git --force git

常见问题解答

Q1：我该如何知道 Git 是否已添加到 PATH 中？

• 在命令提示符或终端中输入 echo $PATH 来查看 PATH 变量的值。如果 C:\Program Files\Git\bin 或 /usr/local/bin 出现在列表中，则 Git 已添加到 PATH 中。

Q2：我该如何修复 npm 的其他 Git 相关错误？

• 首先尝试更新 Git 到最新版本。如果问题仍然存在，请尝试删除 npm 缓存：

npm cache clean --force

Q3：为什么在 npm install 中显式指定 Git 可执行文件？

• 在某些情况下，系统中可能有多个 Git 安装。通过显式指定 Git 可执行文件，可以确保 npm 使用正确的版本。

Q4：我该如何解决与 Git 相关的 npm 安装错误？

• 确保你的 Git 安装已更新且配置正确。你可以使用 git config --list 命令来检查你的 Git 配置。

Q5：我该如何避免将来出现此类错误？

• 定期更新你的 Git 和 npm 安装。同时，在安装任何新软件或更改系统设置之前，请先备份你的重要数据。