重大变更:重复变量标记

变量只允许使用单个 !global!default 标记。重复标记从来没有额外的效果,这只是为了确保样式表更加一致。

第一阶段第一阶段永久链接

兼容性
Dart Sass
从 2.0.0 开始
LibSass
Ruby Sass

从 Dart Sass 2.0.0 开始,如果单个变量声明中包含多个 !global!default 标记,则会发生语法错误。这意味着 $var: value !default !default 将被禁止。$var: value !global !default 仍然是允许的。

过渡期过渡期永久链接

兼容性
Dart Sass
从 1.62.0 开始
LibSass
Ruby Sass

在 Dart Sass 2.0.0 发布之前,标记的多个副本只会产生弃用警告。

我可以静默警告吗?我可以静默警告吗?永久链接

Sass 提供了一套强大的选项,用于管理您看到和何时看到弃用警告。

简洁和详细模式简洁和详细模式永久链接

默认情况下,Sass 运行在简洁模式下,它只会在打印每种类型的弃用警告五次之后才停止打印其他警告。这有助于确保用户知道何时需要意识到即将到来的重大变更,而不会在控制台中产生过多噪音。

如果您在详细模式下运行 Sass,它会打印遇到的所有弃用警告。这对于跟踪修复弃用时剩余的工作量很有用。您可以在命令行中使用 --verbose 标志,或者在 JavaScript API 中使用 verbose 选项来启用详细模式。

⚠️ 注意!

从 JS API 运行时,Sass 在编译之间不会共享任何信息,因此默认情况下,它会针对每个编译的样式表打印五个警告。但是,您可以通过编写(或要求您喜欢的框架的 Sass 插件的作者编写)一个 自定义 Logger 来解决此问题,该 Logger 每种弃用只打印五个错误,并且可以在多个编译中共享。

静默依赖项中的弃用静默依赖项中的弃用永久链接

有时,您的依赖项会有您无法解决的弃用警告。您可以使用命令行中的 --quiet-deps 标志 或 JavaScript API 中的 quietDeps 选项 来静默依赖项的弃用警告,同时仍然为您的应用程序打印警告。

出于此标志的目的,“依赖项”是指任何不是从入口点样式表进行一系列相对加载的样式表。这意味着来自加载路径的任何内容,以及大多数通过自定义导入程序加载的样式表。

静默特定弃用静默特定弃用永久链接

如果您知道特定弃用对您没有问题,您可以使用命令行中的 --silence-deprecation 标志 或 JavaScript API 中的 silenceDeprecations 选项 来静默该特定弃用的警告。