Dart Sass已更新仍报'The legacy JS API is deprecated'弃用警告如何解决？

问题根源 #

你当前使用的gulp-sass版本仍在调用Dart Sass的旧版Legacy JS API，即便Dart Sass本身已是最新版，也会触发该弃用警告。

解决步骤 #

1. 更新gulp-sass到最新版本 #

先卸载旧版gulp-sass，再安装适配Dart Sass新API的最新版：

npm uninstall gulp-sass
npm install gulp-sass --save-dev

2. 修改gulpfile.mjs中的Sass配置 #

将原来的导入和初始化代码：

import dartSass from "sass";
import gulpSass from "gulp-sass";
const sass = gulpSass(dartSass);

替换为：

import sass from 'gulp-sass';

新版gulp-sass已默认集成Dart Sass的新API，无需手动传入dartSass实例。

3. 验证修改 #

重新执行构建命令：

npm run lumis:build

此时弃用警告应该会消失。

若仍有问题，检查你的Sass编译任务代码，确保没有使用旧版API的特定写法，保持任务写法符合新版gulp-sass规范即可。

内容的提问来源于stack exchange，提问作者tico