@error 必须在关键校验点中断编译，否则生成无效CSS；@warn 仅提示潜在问题且可能被构建工具屏蔽；@debug 纯属开发调试，不可交付。判断标准：是否允许生成CSS——无效则用 @error，可用则用 @warn。
@error 必须在关键校验点中断编译，否则生成的 CSS 会出错
当你需要确保某个变量、map 键或计算结果绝对有效时，@error 是唯一能阻止错误 CSS 输出的手段。比如调用 z-index($layer) 时，$layer 不在预设 $z-indexes map 中，继续编译会导致 z-index: null 或 z-index: 0 这类无效值。
常见错误现象：@if $color == null { @error "Color is required" } 仍能通过编译——因为未声明的变量不是 null，而是未定义（undefined）。Sass 中只有 null 是字面量，其余如空字符串 ""、空 map ()、未声明变量，都需用专用函数检测。
- 判变量是否存在：用
variable-exists("color")，不是$color == null - 判 map 键是否存在：用
map-has-key($colors, $color)，不是map-get($colors, $color) == null - 插值进错误信息前，先确认所有变量已定义，否则
@error "Layer #{$layer} not found"会在报你的错误前先报Undefined variable "$layer" - CI 环境下
@error触发构建失败是正常行为；若只想提醒不阻断，就该换用@warn
@warn 适合提示潜在问题，但默认可能被构建工具吞掉
@warn 不中断编译，只输出带 WARNING 前缀的日志，适用于字体单位误用 px、传入边界值（如 $opacity: 0）、或调用已废弃的 legacy-btn-large() 函数等场景。但它极易静默失效。
常见错误现象：写了 @warn "Unknown breakpoint #{$breakpoint}" 却没看到任何输出——问题往往卡在构建链路里。
立即学习“前端免费学习笔记（深入）”；
- Webpack 项目中，
sass-loader默认屏蔽警告，必须显式配置sassOptions: { verbose: true } - Vite 项目中，
@warn只出现在终端构建日志，**不会输出到浏览器控制台** - 用了旧版
node-sass@4.x：插值语法@warn "xxx #{$val}"直接报错，得写成@warn "xxx " + $val - 警告写在未被引用的
_utils.scss里，Dart Sass 不会执行其中任何指令（包括@warn）
@debug 是纯开发自用指令，别让它混进交付代码
@debug 只为验证中间值，比如调试 fluid-font-size($breakpoint) 函数内部 $px 是否取到了正确值。它输出原始 Sass 值（如 16px、rgba(0, 0, 0, 0.5)），不生成 CSS，也不该出现在给团队交付的 mixin 或函数中。
常见错误现象：@debug $color 报错中断编译——因为 $color 是局部变量，而 @debug 写在了作用域外；或者 CI 环境下完全看不到输出，因构建工具默认丢弃 stderr。
-
@debug输出走stderr，@warn走stdout，管道处理时要注意（例如sass src/ | grep debug捕获不到） - 不要对未定义变量或
null直接@debug，会立即中断；先用@if variable-exists("x") { @debug $x; } - Webpack/Vite 中若看不到
@debug，检查sassOptions.verbose是否启用，或 loader 是否用了implementation指向 Dart Sass - 函数或 mixin 的公开接口里禁止出现
@debug，它不属于 API 合约，只用于你本地排查
判断该用 @warn 还是 @error 的唯一标准
核心就一条：这个情况是否允许生成 CSS？
如果生成的样式逻辑上可用（比如单位不对但能渲染、透明度为 0 但布局不崩），就用 @warn；如果生成的 CSS 本身无效、不可用、或必然破坏可访问性/布局（比如 z-index: null、color: map-get($colors, unknown) 返回空、除零计算），就必须用 @error。
容易被忽略的是：warning 和 error 的传播路径完全不同。一个 @warn 在深层函数里触发，若上层没配置 verbose，它就彻底消失；而一个 @error 在最底层触发，整个构建立刻终止——这种“要么全有、要么全无”的特性，决定了你不能靠 @warn 来兜底关键约束。
