解决 uniapp Dart Sass 2.0.0 弃用警告

摘要：

这个警告不是报错，不影响项目运行，只是 Dart Sass 提示你：项目里用了旧版 JS API，未来 Sass 2.0 会移除，需要降级 Sass 版本来消除警告。

核心原因

uniapp 编译工具（vue-loader/style-loader）目前不兼容 Dart Sass 2.x，高版本 Sass 会触发这个弃用警告。

一键解决步骤

1. 卸载高版本 Sass
   打开项目终端，执行：

# 卸载当前高版本 sass
npm uninstall sass --save-dev
# 或 yarn
yarn remove sass

2. 安装兼容的稳定版 Sass
   推荐安装 1.77.8 版本（uniapp 官方兼容的最后一个稳定版）：

# npm 安装
npm install sass@1.77.8 --save-dev
# 或 yarn
yarn add sass@1.77.8 -D
# 或 pnpm
pnpm add sass@1.77.8 -D

3. 清除缓存并重启项目

# 清除uniapp编译缓存
npm run clean
# 重启项目
npm run dev:h5  # 对应你的运行命令（mp-weixin/mp-alipay等）

重启后，这个弃用警告就会完全消失。

补充：为什么不建议用最新版 Sass？

uniapp 基于旧版 Vue2/Vue3 生态，暂未适配 Sass 2.x 新 API

高版本 Sass 除了警告，还可能导致样式编译失败、热更新异常

1.77.8 是兼顾功能和兼容性的最优版本，无任何兼容问题

总结

警告无害，仅提示 API 过时；

核心方案：卸载高版本 → 安装 sass@1.77.8；

清缓存重启项目即可彻底消除警告。