现有项目执行npm install时报错gyp ERR!无法安装依赖问题求助

错误根源说明 #

你遇到的两次报错核心原因都是项目依赖的低版本工具链和当前Node、Python版本不兼容：

1. 第一次报错：node-gyp@3.8.0最高仅支持Node14版本，在Node16环境下无法正确识别调用VS生成工具的MSBuild路径
2. 第二次报错：node-gyp@3.8.0仅支持Python2.7，你系统默认Python版本为3.10，执行Python2语法的print语句触发语法错误
   同时你项目依赖的fibers、node-sass包本身对Node版本兼容性要求极高，旧版本完全不支持Node16环境。

解决方案（二选一即可，优先选第一种，改环境成本最低） #

方案1：降级Node版本（无需修改项目代码） #

• 安装nvm-windows管理多版本Node，卸载当前系统的Node16后，通过nvm安装最新的Node14.x LTS版本
• 重装后执行npm install即可正常安装依赖

方案2：适配Node16环境（保留当前Node版本，修改项目依赖） #

• 全局安装适配Node16的node-gyp版本：

npm install -g node-gyp@9.x

• 配置npm的工具链路径：

# 替换为你本地Python2.7的实际安装路径
npm config set python "C:\Python27\python.exe"
# 替换为你安装的VS生成工具对应的版本，2017/2019/2022都可以
npm config set msvs_version 2022

• 替换项目中的不兼容依赖，用纯JS实现的替代包去掉编译要求：

# 卸载需要编译的旧包
npm uninstall node-sass fibers
# 安装纯JS实现的替代包，业务代码无需修改
npm install sass --save-dev

• 清理缓存重装依赖：

# 删除项目下的node_modules文件夹和package-lock.json文件
npm cache clean --force
npm install

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