使用electron-builder构建Electron应用失败：gyp退出码1求助

问题背景 #

开发Electron应用时使用electron-builder构建Windows可执行文件，环境配置如下：

• Electron-Builder ^23.6.0
• Node.js v14.21.1
• Electron ^10.1.5
• 已安装VS2022（Community/Build Tools）、Python 3.11、node-gyp v8.4.0

构建时触发node-gyp错误，核心提示：

gyp ERR! find VS - missing any Windows SDK
gyp ERR! configure error 
gyp ERR! stack Error: Could not find any Visual Studio installation to use

解决方案 #

1. 安装对应Windows SDK #

打开Visual Studio Installer，选择已安装的VS2022（Community或Build Tools），点击「修改」：

• 勾选**Desktop development with C++**工作负载
• 在右侧「可选组件」中，选择与当前系统版本匹配的Windows SDK（当前系统为Windows 10 10.0.22621，建议选Windows 10 SDK 10.0.22621.x版本）
• 完成安装后重启电脑

2. 修正npm的msvs_version配置 #

打开命令提示符执行以下命令，确保npm指向正确的VS版本：

npm config set msvs_version 2022
# 验证配置是否生效
npm config get msvs_version

3. 清理缓存并重新构建 #

# Windows环境删除依赖文件
rd /s /q node_modules && del package-lock.json
# 重新安装依赖
npm install
# 执行构建
npm run build-installer

4. 兼容问题排查（若以上步骤无效） #

• Python版本降级：node-gyp v8.4.0对Python 3.11兼容性不佳，建议降级到Python 3.10，并配置npm：

  npm config set python python3.10
  

• 使用VS开发者命令行：打开「x64 Native Tools Command Prompt for VS 2022」，切换到项目目录后再执行构建命令，确保VS环境变量正确加载
• 检查PATH优先级：确保Python路径在系统PATH最前端，避免系统调用其他版本的Python

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