dart sass 3.0 移除隐式数学函数并严格解析 / 运算符：必须 @use "sass:math" 显式引入，调用需带命名空间；/ 仅在纯数字间执行除法，变量参与时须改用 math.div()；math.round() 因浮点误差易偏差，应结合 math.floor()/ceil() 与单位处理；calc() 中含变量须插值且确保带单位。
升级到 Dart Sass 3.0 后，math.div()、math.round() 等函数直接调用报错，或 / 运算符行为突变，根本原因不是语法写错了，而是 Dart Sass 3.0 彻底移除了隐式数学函数支持，且强化了除法上下文的语义判定——你写的代码可能在 1.x 版本“碰巧能跑”，但在 3.0 是明确不合法的。
math.div() 报 Function not found：必须显式 @use + 命名空间
Dart Sass 3.0 不再自动挂载 sass:math 模块。即使你写了 math.div(100px, 2)，只要没在文件顶部声明 @use "sass:math"，就会报错 Function "math.div" not found。
-
@import已完全废弃，不能用@import "sass:math"替代 - 必须写成
@use "sass:math"（注意没有引号包裹sass:math的冒号） - 调用时不能省略命名空间：
math.div($a, $b)✅，div($a, $b)❌ - 若多个文件共用，统一在主入口（如
_index.scss）里@use "sass:math" as math，子模块无需重复@use，但也不能跳过继承
/ 运算符突然失效或编译出错：除法上下文被严格解析
Dart Sass 3.0 对 / 的处理更保守。它不再尝试“猜测”你是想做数学除法还是 CSS 字体/行高分隔，而是按规则硬性判断：只要左侧不是纯数字、右侧不是纯数字，就拒绝计算，直接原样输出 / 或报错。
-
width: 100px / 2;✅（左右都确定可算，输出width: 50px;） -
font: 16px/24px;✅（左侧是数字+单位，右侧是数字+单位，符合字体语法） -
grid-column: 1 / 3;✅（CSS Grid 固定语法，被识别为轨道范围） -
height: $h / 2;❌（$h是变量，Sass 不再自动展开计算，可能输出无效 CSS 或中断编译）→ 必须改用math.div($h, 2) -
line-height: $lh / 1.5;❌（同上，变量参与 → 改用math.div($lh, 1.5)）
math.round() 结果偏差大：单位剥离后浮点误差放大
math.round() 本身不处理单位，它只对纯数值做四舍五入。如果你传入 3.75px，Sass 先剥离 px 得到 3.75，round 后得 4，再拼回 px → 4px。看似没问题，但若原始值来自链式计算（如 math.div(100px, 3) → 33.3333333333px），浮点误差会在 round 前就存在，导致结果偏离预期。
- 不要依赖
math.round(math.div($a, $b))做像素对齐，尤其当$b不整除时 - 如需强制整数像素，先用
math.floor()或math.ceil()控制方向，再手动补单位：#{math.floor(math.div($a, $b))}px - 对精度敏感场景（如 rem 转换），优先用
math.div()+math.precision()控制小数位数，而非 round
calc() 里写 $var / 2 编译后变成非法 CSS：Sass 提前运算且不保留 calc 语义
这是最隐蔽的问题：width: calc(100% / 2); 在 Dart Sass 3.0 中，只要 / 两侧都是字面量，Sass 就会直接算成 width: calc(50%);；但如果写成 width: calc(100% / $gap);，它既不会算（因变量不可静态求值），也不会保留原样，而是报错或静默丢弃整条声明。
- 所有含变量的 calc 表达式，必须用插值：
calc(100% / #{$gap})✅ - 但注意：
/在插值后仍由浏览器运行时解析，所以#{$gap}必须是带单位的有效值（如20px），不能是纯数字20 - 如果
$gap来自math.div()计算，确保它已带单位：$gap: math.div(60px, 3);→20px，再插值才安全 - 避免在 calc 内部混用 Sass 函数：
calc(100% / #{lighten($c, 10%)})❌（lighten()需先@use "sass:color"，且返回颜色值，不能直接塞进 calc）
真正容易被忽略的是：Dart Sass 3.0 不再容忍“模糊意图”。它不帮你猜上下文，也不兼容旧习惯。一个 / 是字体分隔符、Grid 轨道范围，还是数学除法，全靠你写的字面形式和是否用了 math. 前缀来决定。没有中间态，也没有警告过渡期。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
