使用Yeoman安装@pnp/generator-spfx时npm模块安装失败求助

报错信息 #

终端核心报错：

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

完整错误栈：

9750 verbose stack Error: An unknown git error occurred
9750 verbose stack     at makeError (C:\Users\a00536820\AppData\Roaming\npm\node_modules\npm\node_modules\@npmcli\git\lib\make-error.js:28:13)
9750 verbose stack     at C:\Users\a00536820\AppData\Roaming\npm\node_modules\npm\node_modules\@npmcli\git\lib\spawn.js:37:26
9750 verbose stack     at processTicksAndRejections (node:internal/process/task_queues:96:5)
9751 verbose cwd C:\code\createNewProject
9752 verbose Windows_NT 10.0.22000
9753 verbose node v16.13.0
9754 verbose npm  v8.19.4
9755 error code ENOENT
9756 error syscall spawn git
9757 error path git
9758 error errno -4058
9759 error enoent An unknown git error occurred
9760 error enoent This is related to npm not being able to find a file.
9760 error enoent
9761 verbose exit -4058
9762 timing npm Completed in 20022ms
9763 verbose unfinished npm timer reify 1693164477702
9764 verbose unfinished npm timer reify:loadTrees 1693164477711
9765 verbose code -4058

已尝试的排查动作 #

• 确认SPFx、Node.js、npm版本符合微软官方兼容性要求
• 单独执行npm install、逐个安装模块
• 删除package-lock.json并重新安装
• 关闭VS Code、重启电脑
• 将项目移至非OneDrive同步文件夹

解决方案 #

• 验证Git安装与系统PATH配置
  打开终端执行git --version，若提示命令不存在：

  1. 安装Git，安装过程中确保勾选「Add Git to your PATH」选项
  2. 重启终端，再次执行git --version确认输出正常版本号

• 手动指定npm的Git路径
  若Git已安装但系统PATH未识别，执行以下命令（路径根据实际安装位置调整）：

  npm config set git "C:\Program Files\Git\bin\git.exe"
  

• 清除npm缓存后重新运行生成器
  执行命令：

  npm cache clean --force
  yo @pnp/spfx
  

• 本地安装生成器并运行
  避免全局安装的生成器出现问题，尝试本地安装：

  npm install @pnp/generator-spfx --save-dev
  npx yo @pnp/spfx
  

• 检查Git代理设置
  企业内网环境下可能存在代理干扰，执行以下命令查看并清理代理：

  # 查看当前代理设置
  git config --global --get http.proxy
  git config --global --get https.proxy
  
  # 清除代理（若不需要）
  git config --global --unset http.proxy
  git config --global --unset https.proxy
  

  清理后重新尝试安装。

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