You need to enable JavaScript to run this app. 执行npm install报node-sass构建、node-gyp语法错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

执行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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 14:15:03