执行npm install报错Build failed with error code:1如何解决

该问题确实与Windows环境变量配置高度相关。重装系统后原有环境变量被重置，导致依赖编译工具匹配到错误的运行环境。

• node-sass@4.12.0的postinstall阶段依赖node-gyp@3.8.0完成二进制编译
• node-gyp@3.8.0仅兼容Python2.7版本，不支持Python3语法
• 重装系统后Python2的路径未加入环境变量，node-gyp检索环境变量时优先匹配到Python3.10路径，执行带Python2语法的编译脚本时触发print语句缺失括号的语法错误

• 验证Python路径优先级：打开命令提示符执行where python，若输出的第一条路径为Python3.10的安装路径，即可确认环境变量优先级异常
• 检查npm的Python配置：执行npm config get python，若输出为空或指向Python3路径，说明npm全局配置未指定适配的Python版本
• 验证Node版本兼容性：执行node -v，node-sass@4.12.0仅兼容Node 8、10、11、12四个大版本，若当前Node版本高于12也会触发编译错误

提供两种可选项，优先选择无编译依赖的方案：

方案1：替换node-sass为dart-sass（推荐） #

dart-sass是node-sass的官方替代实现，无原生编译依赖，无需配置Python环境即可运行，绝大多数旧项目可直接无缝替换：

npm uninstall node-sass
npm install sass --save-dev

方案2：保留node-sass，配置适配的编译环境 #

若业务需要必须保留node-sass@4.12.0版本，按以下步骤操作：

1. 下载安装Python2.7，安装时勾选「Add Python to PATH」选项，或手动将Python2.7的安装目录、Python2.7下的Scripts目录添加到系统环境变量Path中，且配置优先级高于Python3.10的路径
2. 全局设置npm使用的Python版本：

npm config set python python2.7

3. 安装Windows原生编译工具，以管理员身份打开命令提示符执行：

npm install --global --production windows-build-tools@4.0.0

4. 清空项目缓存后重新安装依赖：

rd /s /q node_modules
del package-lock.json
npm cache clean --force
npm install

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