Vue.js现有项目npm install报错：已装Python仍提示找不到Python

问题场景 #

启动Vue.js开发的现成UI项目，执行npm install时出现报错，已安装Python并配置环境变量，CMD中输入python可正常调用编译器。

报错信息 #

npm ERR! code 1
npm ERR! path C:\Users\ismai\Desktop\smartupwebui\smartupui\app-src\node_modules\fibers
npm ERR! command failed
npm ERR! command C:\WINDOWS\system32\cmd.exe /d /s /c node build.js || nodejs build.js
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp info using node-gyp@3.8.0
npm ERR! gyp info using node@18.12.1 | win32 | x64
npm ERR! gyp ERR! configure error 
npm ERR! gyp ERR! stack Error: Can't find Python executable "python", you can set the PYTHON env variable.
npm ERR! gyp ERR! stack     at PythonFinder.failNoPython (C:\Users\ismai\Desktop\smartupwebui\smartupui\app-src\node_modules\node-gyp\lib\configure.js:484:19)       
npm ERR! gyp ERR! stack     at PythonFinder.<anonymous> (C:\Users\ismai\Desktop\smartupwebui\smartupui\app-src\node_modules\node-gyp\lib\configure.js:509:16)        
npm ERR! gyp ERR! stack     at callback (C:\Users\ismai\Desktop\smartupwebui\smartupui\app-src\node_modules\graceful-fs\polyfills.js:295:20)
npm ERR! gyp ERR! stack     at FSReqCallback.oncomplete (node:fs:207:21)
npm ERR! gyp ERR! System Windows_NT 10.0.22621
npm ERR! gyp ERR! command "C:\\Program Files\\nodejs\\node.exe" "C:\\Users\\ismai\\Desktop\\smartupwebui\\smartupui\\app-src\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild" "--release"
npm ERR! gyp ERR! cwd C:\Users\ismai\Desktop\smartupwebui\smartupui\app-src\node_modules\fibers
npm ERR! gyp ERR! node -v v18.12.1
npm ERR! gyp ERR! node-gyp -v v3.8.0
npm ERR! gyp ERR! not ok
npm ERR! node-gyp exited with code: 1
npm ERR! Please make sure you are using a supported platform and node version. If you
npm ERR! would like to compile fibers on this machine please make sure you have setup your
npm ERR! build environment--
npm ERR! Ubuntu users please run: `sudo apt-get install g++ build-essential`
npm ERR! RHEL users please run: `yum install gcc-c++` and `yum groupinstall 'Development Tools'`
npm ERR! Alpine users please run: `sudo apk add python make g++`
npm ERR! 'nodejs' is not recognized as an internal or external command,
npm ERR! operable program or batch file.

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\ismai\AppData\Local\npm-cache\_logs\2023-07-07T10_59_22_861Z-debug-0.log

解决方法 #

1. 手动指定Python路径给node-gyp #

尽管全局环境能调用python，但node-gyp可能未正确读取到路径，可通过以下方式指定：

• 临时生效（当前命令行窗口）：
  替换为你的Python实际路径后执行，再重新跑npm install：

  set PYTHON=C:\你的Python安装路径\python.exe
  

• 永久生效：
  右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→「系统变量」中新建：
  • 变量名：PYTHON
  • 变量值：Python.exe的完整路径（如C:\Python39\python.exe）

2. 修复nodejs命令识别问题 #

Windows下Node.js默认命令为node，报错中nodejs未被识别，可通过软链接解决：
找到Node.js安装目录（通常为C:\Program Files\nodejs），复制其中的node.exe并重命名为nodejs.exe。

3. 升级node-gyp并清理缓存 #

当前使用的node-gyp@3.8.0版本较老，与Node.js 18.x兼容性不佳，执行以下步骤：

# 全局升级node-gyp
npm install -g node-gyp
# 清理npm缓存
npm cache clean --force
# 删除旧依赖文件
rm -rf node_modules package-lock.json
# 重新执行安装
npm install

4. 安装Windows构建工具 #

node-gyp依赖微软编译工具，直接安装官方工具包：

npm install -g windows-build-tools

该工具会自动安装Python及必要的编译组件，确保构建环境完整。

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