Sass 本身不理解 @layer，但可无缝配合 Cascade Layers 使用——关键在于编译时机和层声明位置，否则会意外打乱层序或生成无效 CSS；必须将 @layer 声明统一置于所有 Sass 模块拼接后的 CSS 最顶部，且仅出现一次，所有层内样式需严格包裹在对应 @layer 块中，禁止嵌套或动态生成。
直接说结论：Sass 本身不理解 @layer，但可以无缝配合 Cascade Layers 使用——关键在于编译时机和层声明位置，否则会意外打乱层序或生成无效 CSS。
为什么 Sass 编译后可能破坏 @layer 顺序
Sass 是预处理器，所有 @layer 声明必须在 CSS 层级生效前就已确定顺序。而 Sass 的 @import（已废弃）或 @use 会改变代码拼接顺序，导致层声明被“拆开”或“错位”。
-
@layer base, components, utilities;必须出现在所有层样式定义之前，且只能出现一次（重复声明会重置层序） - 若把
@layer base { ... }写在某个@use "base"模块里，而该模块又被多个文件@use，就可能产生多份@layer base，浏览器只认第一个，其余被忽略 - Sass 的嵌套规则（如
.btn { @layer components { &--primary { ... } } }）是非法的：@layer不能出现在选择器内部，会被编译为无效语法
正确组织方式：层声明统一前置 + 模块按层导入
把层定义和层内样式分离，用 @use 控制加载顺序，确保 CSS 输出结构符合 Cascade Layers 要求。
- 建一个
_layers.scss文件，仅包含层声明：@layer reset, base, components, utilities; - 每个模块对应一层，例如
_base.scss开头写@layer base {，结尾写}；_components.scss同理用@layer components { ... } - 主文件中严格按层优先级顺序
@use：@use "layers"; @use "base"; @use "components"; @use "utilities"; - 禁止在任何
@mixin或嵌套中生成@layer—— 它不是运行时逻辑，而是静态层序契约
容易踩的坑：Sass 变量 / mixin 与层优先级无关
有人误以为用 $layer-order: (reset, base, components) 配合循环生成 @layer 就能动态控制优先级，这是错的。
立即学习“前端免费学习笔记（深入）”；
- Cascade Layers 的优先级只取决于
@layer声明语句在最终 CSS 中的**文本顺序**，和 Sass 变量、循环完全无关 -
@layer不支持表达式，@layer #{$name} { ... }是语法错误 - mixins 里插入样式时，必须明确写进某一层内，比如：
@mixin btn-reset { @layer base { & { margin: 0; padding: 0; } } }，否则生成的样式落在未声明层，优先级反而最高（易覆盖其他层）
调试时重点看编译后的 CSS，不是 Sass 源码
浏览器开发者工具的 Styles 面板里，@layer 是可见的，但不会高亮显示层间优先级关系。真正要确认是否生效，得看：
- 最终 CSS 文件中，
@layer reset, base, components, utilities;是否唯一且在最前 - 各层样式块是否完整包裹在对应
@layer xxx { ... }内，没有漏掉右括号或被注释截断 - 检查冲突样式：右键元素 → “Computed” → 找目标属性 → 点击右侧样式来源，看它属于哪个 layer，以及该 layer 在声明列表中的位置
- 如果某条样式没被覆盖，但预期该被
@layer utilities覆盖，先确认它是否真的在utilities层里——Sass 编译错误常导致样式“掉层”到无层上下文
最麻烦的地方不是写不对，而是写对了但编译链路里某个 @use 或 @forward 悄悄挪动了层声明位置。每次改完 Sass，务必打开生成的 CSS 文件扫一眼 @layer 结构是否干净。
