npm install安装vue-element-admin报错npm ERR! -4058 enoent An unknown git error occurred的解决方案

本是古典何须时尚 2024-03-23 19:25 69阅读 0赞

说明：该篇博客是博主一字一码编写的，实属不易，请尊重原创，谢谢大家！

## 问题描述 ##

很多朋友特别是对`node.js`完全不熟悉了解的，大多都是从仓库直接拉取下载项目到本地，第一时间就是想在本地启动运行项目，完全不懂直接开干，当遇到错误时就蒙了

比如当我们从远程仓库拉取或下载`vue-element-admin`项目到本地后，通过`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
    
    npm ERR! A complete log of this run can be found in:
    npm ERR!     D:\Program Files\nodejs\node_cache\_logs\2023-08-08T00_48_42_038Z-debug-0.log

![在这里插入图片描述][7757382233594b1fbf4a184191d26eee.png]

## 原因分析 ##

> 首选要明白`npm install`这个命令是意思，做了什么事情，知道了这个才能去更好的定位问题的来源，很多执行命令报错也应该这样分析

### 什么是 npm install 命令？ ###

`npm install` 是 `Node Package Manager (npm)` 的一个命令，用于在项目中安装所需的依赖包。它会读取项目目录中的 `package.json` 文件，并从 `npm registry` 下载定义的依赖包。在项目中使用依赖包的代码之前，通常需要先运行 `npm install` 命令，然后依赖包就会被安装到 `node_modules` 目录下。

### 可能遇到的 Git 错误 ###

为啥要说可能，说真的在 `npm install` 安装项目依赖包时，根据博主的经验来说可能你不是每一次安装时都会出现该 `git error`提示，我们要知道npm本身不需要安装git，但是如果你在安装某些`npm`包时需要使用`git`，那么你就需要安装`git`并确保它已经在你的系统路径中。

## 解决方法 ##

该错误通常是由于`Git`未正确安装或未配置`PATH`环境变量而引起的。`npm`在执行操作时需要`Git`，但无法找到所需的文件或路径，因此出现了“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”

为了避免可能遇到的`Git`错误，那么可以通过如下方法进行解决：

### 安装Git： ###

请参考博主这篇文章即可《[最新GitHub新手使用教程(Windows Git从安装到使用)——详细图解][GitHub_Windows Git]》

### 配置Git环境变量： ###

当我们安装完`Git`后，在`cmd`命令终端上输入`git`是提示找不到的，所以需要配置环境变量  
  
![在这里插入图片描述][45a8906f095441bdace192406214224f.png]

未配置`Git`环境变量时，在终端输入 `where git` 会提示找不到文件  
  
![在这里插入图片描述][66aa46b5975744edbe70a9525aa63995.png]

编辑系统变量—>Path—输入安装`Git`的路径，这里路径是到`cmd`目录，比如你的安装目录是`C:\Program Files\Git`，那么就是`C:\Program Files\Git\cmd`  
  
![在这里插入图片描述][b8b18bd9ed594bbbb5b6ae71a471ec46.png]

完成环境变量配置后，再次终端执行`where git`命令，就会看到系统找到了`git`执行目录了

where git
    git --version

![在这里插入图片描述][99b5efcb68ae448db73bbeb5b116df0a.png]

**注意：** 重启下你的电脑，再次执行`npm install` 命令，所有`git`相关的问题全部解决  
  
![在这里插入图片描述][12c3de7cf62d43d7afe6f18ecdb99295.png]

[7757382233594b1fbf4a184191d26eee.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/688ef197bf7d460b91c6a3fa8a4b5618.png
[GitHub_Windows Git]: https://cdtaogang.blog.csdn.net/article/details/85183250
[45a8906f095441bdace192406214224f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/1fc05ff2887a4ff4920307a32aab95f5.png
[66aa46b5975744edbe70a9525aa63995.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4b30de657758439cb6a7c12d5aa12b0e.png
[b8b18bd9ed594bbbb5b6ae71a471ec46.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/fc4dfa6ebc6743199e57a99fb19cc977.png
[99b5efcb68ae448db73bbeb5b116df0a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/e7d32426b161400c9cb8b7bf7aa19bae.png
[12c3de7cf62d43d7afe6f18ecdb99295.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/d488d082406e4fdebf4fad003a0f2107.png