Windows环境安装Electron项目遇node-gyp的distutils缺失错误

问题根源 #

Python 3.12默认移除了distutils模块，而node-gyp编译原生模块时依赖该模块，这是报错的核心原因。

解决步骤 #

• 安装包含distutils的setuptools包
  打开命令提示符，执行：

  pip install setuptools
  

• 指定node-gyp使用的Python版本
  把命令里的路径替换成你实际的Python 3.12安装路径，执行：

  npm config set python "C:\Program Files\Python312\python.exe"
  

• 确认Visual Studio编译环境配置正确

  1. 打开Visual Studio 2022，确保已安装「桌面开发使用C++」工作负载，包含MSVC编译器、Windows SDK组件
  2. 以管理员身份打开命令提示符，运行VS的环境配置脚本（路径根据你的VS版本和安装位置调整）：

     "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" x64
     

• 重新执行项目安装
  回到项目目录，删除node_modules文件夹和yarn.lock文件，然后重新运行：

  yarn install
  

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