Windows环境安装RudderStack执行npm i时node-gyp找不到Python报错求助

问题核心 #

本次报错是node-gyp工具无法识别到已安装的Python环境，导致heapdump原生包编译失败，按照以下步骤操作即可修复：

修复步骤 #

• 首先验证Python环境配置有效性：打开命令提示符执行python --version或python3 --version，如果提示命令不存在，说明Python并未正确加入系统PATH环境变量。请将Python安装根目录（例如C:\Python39\）以及根目录下的Scripts文件夹路径，添加到系统PATH后重启终端重新验证。
• 给npm显式指定Python路径：执行命令npm config set python "你的Python实际安装路径\python.exe"，配置完成后可以执行npm config get python确认配置生效。
• 安装Windows编译依赖：使用管理员权限打开PowerShell，执行npm install --global --production windows-build-tools，该工具会自动配置node-gyp所需的C++编译环境与Python路径。
• 重装项目依赖：删除项目根目录下的node_modules文件夹与package-lock.json文件，重新执行npm i即可。
• 临时规避方案：如果不需要使用heapdump的调试功能，可以执行npm i --ignore-scripts跳过编译步骤直接安装依赖。

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