uni-app Node Sass版本报错：Error Node Sass version 9.0.0 is incompatible with ^4.0.0 只能安装4.0.0版本 但安装后无法使用并运行

发布于 1周前 作者 bupafengyu 来自 Uni-App

uni-app Node Sass版本报错：Error Node Sass version 9.0.0 is incompatible with ^4.0.0 只能安装4.0.0版本 但安装后无法使用并运行

操作步骤：

  • vue-cli vue create -p dcloudio/uni-preset-vue my-project创建项目，安装下载node-sass并使用

预期结果：

  • 创建项目，下载node-sass安装并使用，正常运行项目

实际结果：

  • 报错，无法运行

bug描述：

用官网vue-cli vue create -p dcloudio/uni-preset-vue my-project创建项目，下载node-sass，会报错只能下载4.0.0。 重新下载了4.0.0版本后运行就会报错。

图片

Image 1 Image 2 Image 3

信息 描述
产品分类 uniapp/H5
PC开发环境 Windows
PC开发环境版本 windows 11
浏览器 Chrome
浏览器版本 130.0.6723.70（正式版本）
项目创建方式 CLI
CLI版本 @vue/cli@5.0.8

Harmonyos Next教程
1 回复

遇到uni-app中Node Sass版本不兼容的问题时，通常是由于项目中依赖的某些包要求特定版本的Node Sass。尽管直接修改Node Sass版本可能会暂时解决问题，但更好的做法是通过配置package.json和相应的构建脚本来确保所有依赖项版本的一致性。

以下是一个解决此类问题的示例步骤，包括如何使用npm脚本来自动安装正确版本的Node Sass：

  1. 修改package.json以指定Node Sass版本： 在package.json中，你可以使用engines字段指定Node.js的版本，尽管这不是直接解决Node Sass版本问题的方法，但它有助于确保环境的一致性。对于Node Sass，你应该直接在dependencies或devDependencies中指定版本。

    {
  "dependencies": {
    "node-sass": "^4.0.0"
  },
  "devDependencies": {},
  "scripts": {
    "install-sass": "npm install node-sass@^4.0.0"
  }
}

  2. 使用npm脚本来安装Node Sass： 添加一个自定义的npm脚本来安装指定版本的Node Sass。这样做的好处是，无论何时项目被克隆或在新环境中设置，运行这个脚本都能确保安装了正确版本的Node Sass。

    npm run install-sass

  3. 确保构建脚本考虑Node Sass版本： 如果你的构建过程依赖于特定的Node Sass版本，确保构建脚本（如npm run build）在尝试编译SASS文件之前检查或安装正确的Node Sass版本。

  4. 使用postinstall钩子： 另一个选择是在package.json中使用postinstall脚本来自动安装或验证Node Sass版本。

    {
  "scripts": {
    "postinstall": "npm run install-sass || echo 'Node Sass installation failed but continuing...'"
  }
}

  5. 考虑使用Dart Sass（sass）作为替代： Node Sass已经被官方宣布为已弃用，推荐转向Dart Sass。Dart Sass是纯JavaScript实现，与Node.js有更好的兼容性，且通常更新更快。

    {
  "dependencies": {
    "sass": "^1.0.0"
  }
}

    然后，在你的构建或运行脚本中，确保使用的是sass命令而不是node-sass。

通过上述方法，你可以更有效地管理uni-app项目中的Node Sass版本问题，同时保持项目依赖的清晰和一致性。

回到顶部