执行npm install报node-sass构建、node-gyp语法错误如何解决?
报错根因
- node-sass与Node.js版本不兼容:当前使用的Node.js版本为16.2.0,项目依赖的旧版node-sass不支持该Node版本,其关联依赖node-gyp@3.8.0仅支持Python2,你本地环境安装的是Python3.9,执行Python2语法的校验代码时触发语法错误,最终导致编译安装失败。
- node-sass官方已全面停止维护,不会再适配高版本Node.js和新系统环境,继续使用会持续出现兼容性问题。
解决方案
最优方案(推荐,无额外环境依赖)
直接将已废弃的node-sass替换为官方推荐的dart-sass(包名为sass),完全兼容原有sass语法,无需修改任何业务代码:
- 先删除项目根目录下的
node_modules文件夹、package-lock.json文件(若用yarn则删除yarn.lock) - 卸载原有node-sass依赖:
npm uninstall node-sass
- 安装替代包sass:
npm install sass -D
- 重新执行全量依赖安装即可正常启动项目:
npm install
备选方案(仅适用于必须保留node-sass的场景)
二选一即可:
- 降级Node.js版本到和项目现有node-sass匹配的版本:若项目中node-sass版本为v4.x,Node.js版本需要降到14.x及以下;若为v5.x对应Node.js 15.x,v6.x对应Node.js 16.x
- 升级node-sass到适配Node.js 16的v6.0+版本,同时本地安装Python2.7并配置到系统环境变量,执行
npm config set python python2.7指定node-gyp的Python版本后,再重新执行npm install
内容的提问来源于stack exchange,提问作者RROSANN
相关产品推荐
相关产品推荐

