从GitHub克隆React项目后npm install出现npm ERR! code 1错误的原因及解决方法

一、失败核心原因 #

从你提供的报错日志来看，问题出在两个关键地方：

1. 旧版node-gyp不兼容Python3：项目依赖的node-gyp@3.8.0是较老的版本，它默认使用Python2的语法（比如print "%s.%s.%s"这种写法），但你本地安装的是Python3.9，执行这段代码时直接触发了语法错误。
2. Node.js版本与node-sass不匹配：你当前使用的Node.js是v16.6.1，而项目里的node-sass版本（对应旧版node-gyp）并不支持Node.js 16，这也导致了构建失败。

结论：不需要更新Python，反而要解决版本兼容问题

二、具体解决步骤 #

推荐按优先级尝试以下方案：

方案1：升级node-sass到兼容Node.js 16的版本（最推荐） #

这是最彻底的解决方式，而且node-sass已经停止维护，新版的sass（dart-sass）兼容性和稳定性更好：

• 先卸载旧的node-sass：

npm uninstall node-sass

• 二选一安装适配版本：

# 安装兼容Node.js 16的node-sass版本
npm install node-sass@6.0.0 --save-dev

# 或者替换为更稳定的dart-sass（推荐长期使用）
npm install sass --save-dev

方案2：配置node-gyp使用Python3（适合不想改动项目依赖的情况） #

旧版node-gyp可以通过强制配置来适配Python3：

1. 设置npm的Python路径：

npm config set python C:\Python39\python.EXE

2. 安装Windows编译工具（自动配置所需的编译环境）：

npm install --global windows-build-tools

3. 删除本地旧依赖文件后重新安装：

# Windows系统执行
rd /s /q node_modules && del package-lock.json
npm install

方案3：降级Node.js到兼容版本 #

如果不想改动项目依赖，可以把Node.js降级到v14.x（旧版node-sass普遍支持这个版本），推荐用nvm来管理Node版本：

1. 安装nvm后，执行以下命令安装并切换到Node.js 14：

nvm install 14.19.0
nvm use 14.19.0

2. 清理旧依赖后重新安装：

# Windows系统执行
rd /s /q node_modules && del package-lock.json
npm install

三、验证启动 #

完成上述操作后，重新执行npm install，如果没有报错，再运行npm start就能正常启动React项目了。

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