执行npm install时因node-gyp错误无法安装node modules问题求助

• 项目依赖的node-sass版本和你本地安装的node@15.14.0不兼容，不同版本的node-sass仅支持指定范围的Node版本，版本不匹配会触发本地编译逻辑
• 本地缺少node-sass编译所需的依赖环境：缺少Python2.7运行时、MSVC构建工具链
• 单独全局安装/升级node-gyp无法解决问题，因为项目依赖的node-sass内置绑定了指定版本的node-gyp，默认不会调用全局安装的版本

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

node-sass已停止官方维护，dart-sass是官方主推的替代实现，无需本地编译，兼容性更强，且完全兼容原有sass语法，无需修改业务代码：

• 先卸载原有node-sass依赖

npm uninstall node-sass

• 安装dart-sass（npm包名为sass）

npm install sass --save-dev

• 清空缓存后重新安装全量依赖即可

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

兼容方案：保留node-sass的修复步骤 #

如果项目有特殊约束无法替换依赖，按以下步骤操作：

1. 先卸载全局安装的node-gyp，避免版本冲突

npm uninstall -g node-gyp

2. 以管理员权限打开PowerShell，安装Windows构建工具包，内置Python2.7和MSVC编译链

npm install -g windows-build-tools

3. 匹配node-sass和Node版本：Node 15.x对应的兼容node-sass版本为v5.0+，检查项目package.json中node-sass的版本号，不符合要求则升级到兼容版本
4. 清空缓存重新安装依赖

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

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