Yarn 安装 Node-Sass 失败解决方法

本文将解决使用 Yarn 安装 Node-Sass 时遇到的常见问题，帮助开发者快速配置开发环境。

问题概述

在使用 Yarn 安装 Node-Sass 时，可能会遇到以下错误：

“node-sass” 版本不兼容
编译器缺失或版本过旧
依赖安装失败

准备工作

确保已安装以下依赖：

Node.js (建议使用 LTS 版本)
Yarn (建议使用最新版本)
编译器 (如 Dart)

检查 Node.js 和 Yarn 版本

node -v
yarn -v

安装 Dart 编译器

Node-Sass 依赖 Dart 进行编译，必须先安装 Dart：

Linux/macOS

sudo apt update
sudo apt install dart

Windows

Yarn 安装 Node-Sass 失败怎么解决

wget https://storage.googleapis.com/dart-archive/channels/stable/release/2.18.0/windows/dart_2.18.0-5179342 windows_x64.exe
dart_2.18.0-5179342 windows_x64.exe /install

安装 Node-Sass

尝试直接安装 Node-Sass 并查看错误信息：

yarn add node-sass

解决常见错误

1. 版本不兼容错误

如果出现版本不兼容错误，尝试指定兼容的版本：

yarn add node-sass@4.14.1

2. 编译器缺失错误

如果提示 Dart 未安装或版本过低，先安装 Dart：

yarn add node-sass --dev
# 然后运行
yarn install

3. 依赖冲突

如果遇到其他依赖冲突，可以尝试清理缓存：

yarn cache clean
yarn add node-sass@4.14.1

使用 npm 替代方案

如果 Yarn 安装始终失败，可以考虑使用 npm：

npm install node-sass@4.14.1 --save-dev

手动编译测试

为确认安装是否成功，可以手动编译一个 Sass 文件：

touch test.scss
echo "h1 { color: red; }" > test.scss
npx node-sass test.scss test.css

检查 test.css 文件是否生成。

环境变量配置

确保 Dart 的路径已添加到系统环境变量中：

export PATH=$PATH:/usr/bin/dart
# Windows
set PATH=%PATH%;C:\Program Files\dart\sdk\bin

其他注意事项

避免使用过旧的 npm 或 Yarn 版本
保持系统依赖更新
尝试使用最新版本的 Node-Sass