Deprecation Warning: The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.

关于Dart Sass 2.0.0 中移除遗留JS API 的弃用警告解决方案
配置Vite解决Sass警告
为了消除The legacy JS API is deprecated and will be removed in Dart Sass 2.0.0.这一警告，在配置文件 vite.config.ts 中可以设置 SCSS 使用现代编译器API：
export default defineConfig({
css: {
preprocessorOptions: {
scss: {
api: 'modern-compiler'
}
},
},
})
登录后复制
此段代码通过指定SCSS预处理器选项中的API为现代化版本来规避旧版JavaScript接口带来的警告[^1]。
对于Nuxt框架下的Vite构建工具而言，另一种有效的做法是在定义的配置对象里加入特定参数以静默废弃特性提醒:
export default defineNuxtConfig({
vite: {
css: {
preprocessorOptions: {
sass: {
silenceDeprecations: ["legacy-js-api"],
},
},
},
},
});
登录后复制
上述方式能够有效抑制有关过时功能的通知而不影响其他正常工作流程[^2]。
如果项目中有全局共享样式变量或其他资源的需求，则可以在同一位置继续追加路径指向公共样式表单的同时保持对陈旧API警报的屏蔽效果:
//vite.config.ts
export default defineConfig({
//..other config
css: {
preprocessorOptions: {
scss: {
additionalData: '@import "./src/assets/scss/var.scss";',
silenceDeprecations: ["legacy-js-api"]
},
},
}
})
登录后复制
这段配置不仅解决了警告问题还实现了SCSS文件间的继承关系维护[^3]。
最后一种综合性的方案是同时设定新的API模式并禁言特定类型的警告消息:
export default defineConfig({
css: {
preprocessorOptions: {
scss: {
silenceDeprecations: ['legacy-js-api'],
api: 'modern-compiler', // 或者使用'modern'
}
}
}
})
登录后复制
这种方法既指定了更先进的API形式又消除了不必要的输出干扰[^4]。