Dart Sass 不是“取代”,而是唯一能编译现代 CSS 的实现——Node Sass 基于弃用的 libsass,解析 calc(100% / 3) 或 @container 时在词法层崩溃,无法识别 CSS 原生语法;Dart Sass 分层解析,支持新特性并强制规范书写。

Dart Sass 不是“取代了 Node Sass”,而是 Node Sass 已无法通过编译——你写 calc(100% / 3) 或 @container,它直接报错,连词法层都过不去。
Node Sass 解析 calc() 中的 / 就崩溃
这不是配置问题,是底层解析器设计缺陷:Node Sass 基于已弃用的 libsass,把所有 / 都当 Sass 除法运算符处理,哪怕它明明白白写在 calc() 里。
-
width: calc(100% / 3);→ 报错SassError: Invalid CSS after "100%": expected expression - 加
// sass:disable-next-line没用——错误发生在词法解析阶段,根本没走到注释处理逻辑 - 你不能靠“绕过”解决,因为 libsass 压根不识别
calc()是 CSS 原生函数
Dart Sass 才能正确编译 @container、color-mix() 等现代 CSS 特性
Dart Sass 把 CSS 原生语法交给标准 parser 处理,Sass 扩展逻辑再叠加,所以新特性可无损透出。
-
@container (min-width: 400px) { .card { } }→ Dart Sass 输出合法 CSS;Node Sass 直接报Unknown at rule -
background: color-mix(in srgb, red 50%, blue);→ Dart Sass 支持;Node Sass 完全不认识该 token -
@use "sass:math"和@use "sass:color"提供对math.div()、hwb()、color-contrast()的完整支持,LibSass 根本不解析@use
Vue/React 项目迁移最常卡在 ::v-deep 写法上
这不是“语法糖差异”,是解析规则升级:Dart Sass 严格按 CSS 规范解析伪类,容错性归零。
- 错误写法:
::v-deep.foo→ Dart Sass 当成伪类名解析,报Unknown pseudo-class selector "::v-deep.foo" - 正确写法:
::v-deep .foo(注意空格)→ 表示“后代选择器”,样式才能生效 -
/deep/已被完全移除,无法通过sass-loader降级兼容;>>同样失效
迁移只需两步,但工具链配置容易漏掉
看似简单,实操中常因残留旧配置导致构建失败:
- 卸载:
yarn remove node-sass或npm uninstall node-sass - 安装:
yarn add sass -D(注意不是dart-sass,该包早已重定向并弃用) - 检查
sass-loader配置:Vite / Vue CLI 默认已设implementation: require('sass'),但若项目有手动配置指向node-sass,会触发Module build failed: SassError: Invalid CSS after ""
真正难的不是换包,而是意识到:Node Sass 的“兼容”其实是放任错误,而 Dart Sass 的“报错”才是 CSS 规范本该有的样子。那些过去能跑通的写法,往往本身就是非法 CSS。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











