执行npm install时出现errno 4058（ENOENT）错误求助

执行npm install时触发以下错误：

npm ERR! code ENOENT
npm ERR! syscall spawn git
npm ERR! path git
npm ERR! errno -4058
npm ERR! enoent An unknown git error occurred
npm ERR! enoent This is related to npm not being able to find a file.
npm ERR! enoent

完整日志路径：C:\Users\MyUserName\AppData\Local\npm-cache\_logs\2022-11-14T19_25_44_768Z-debug-0.log

已尝试的修复操作均无效：

• 清理npm缓存
• 更新npm
• 重装npm
• 重建缓存
• 删除package-lock.json

项目package.json内容如下：

{
   "name": "project-x",
   "version": "1.5.9",
   "main": "src/index.js",
   "license": "Unlicensed",
   "scripts": {
      "start": "node ."
   },
   "engines": {
      "node": "14.x"
   },
   "dependencies": {
      "@discordjs/uws": "^10.149.0",
      "@skyra/timestamp": "^1.0.0",
      "chalk": "4.1.2",
      "discord.js": "localip/discord.js#master",
      "discord.js-light": "localip/discord.js-light#master",
      "dotenv": "github:andreialecu/dotenv#feat-multiline",
      "express": "^4.17.1",
      "json5": "^2.2.0",
      "moment": "^2.29.1",
      "phin": "github:localip/phin"
   }
}

怀疑问题与GitHub仓库引用有关，寻求可行解决方案。

核心原因 #

错误提示系统找不到git命令，而你的package.json中多个依赖直接引用了GitHub仓库（如discord.js: localip/discord.js#master），npm安装这类依赖必须调用git克隆仓库，因此问题根源是系统无法调用git工具。

分步解决 #

1. 检查Git是否安装
   打开CMD或PowerShell，执行git --version，若提示命令不存在，说明未安装Git。安装时务必勾选“Add Git to PATH”选项，确保系统能全局调用git。

2. 确认Git已加入系统PATH
   若已安装Git仍报错，检查环境变量：

   • 右键“此电脑”→属性→高级系统设置→环境变量
   • 在系统变量的PATH中，确认包含Git的bin目录（如C:\Program Files\Git\bin或C:\Program Files\Git\cmd）
   • 若缺失，手动添加该路径，保存后重启命令行再执行npm install

3. 验证GitHub仓库可访问性
   尝试直接克隆依赖中的GitHub仓库，比如执行git clone https://github.com/localip/discord.js.git：

   • 若为私有仓库，需配置GitHub凭证：
     • HTTPS方式：执行git config --global credential.helper wincred，后续克隆时输入GitHub账号密码；
     • SSH方式：生成SSH密钥并添加到GitHub账号的SSH设置中。

4. 替换GitHub引用为官方npm包（可选）
   如果上述方法仍无法解决，可尝试将GitHub直接引用替换为官方npm包：

   • 比如discord.js改为"discord.js": "^14.x"（根据项目需求选择适配版本）；
   • dotenv改为官方包"dotenv": "^16.x"，若需多行环境变量功能，可改用支持该特性的替代包或自行处理。

内容的提问来源于stack exchange，提问作者Gamerztour Playz