math.div()是SCSS 6.0+中/除法被禁用后的唯一合规替代方案,必须@use "sass:math"导入并带命名空间调用,参数须单位一致或无单位,不支持隐式单位转换;calc()内/仍安全。

SCSS 6.0+ 中 / 除法被禁用后,math.div() 是唯一合规替代方案
SCSS 6.0 开始,/ 在纯数值计算中不再被识别为除法运算符(仅保留在 CSS 值上下文中,如 font: 16px/1.5),直接写 100px / 4 会报错:Invalid CSS after "...": expected expression (e.g. 1px, bold), was "100px / 4"。必须改用 math.div() —— 它不是可选项,是强制要求。
math.div() 的参数规则和常见误用
该函数严格要求两个参数:被除数、除数,且**不支持单位自动推导或隐式转换**。比如 math.div(100px, 4) 合法,但 math.div(100px, 2px) 会报错:Expected number, got "2px"(除数不能带单位);反过来 math.div(100, 4px) 同样非法。
- ✅ 正确:
math.div(100, 4)、math.div(100px, 4)、math.div(2.5rem, 2) - ❌ 错误:
math.div(100px, 2px)、math.div($width, $height)(若两者都含单位) - ⚠️ 注意:
math.div(100, 0)不会编译报错,但运行时可能触发 Sass runtime error
在响应式断点和栅格计算中怎么安全替换旧写法
老项目里常见 $gutter: 20px; .col { width: 100% / 3 - $gutter; } 这类写法,升级后必须拆解并确保单位一致:
@use "sass:math";
<p>$gutter: 20px;
.col {
// ❌ 错误:math.div(100%, 3) - $gutter → % 和 px 单位无法混合运算
// ✅ 正确:先算比例值(无单位),再乘以 100% 或转为目标单位
width: math.div(100, 3) * 1% - $gutter;
}
</p>
- 百分比计算优先用
math.div(100, N) * 1%,避免对带单位值做除法 - 栅格列宽若基于容器宽度,推荐用
calc()留给 CSS 运行时处理:width: calc((100% / 3) - #{$gutter}); - 变量参与运算前,用
unitless()检查是否可除:@if not unitless($ratio) { @error "Ratio must be unitless"; }
兼容旧版 SCSS 和构建工具的注意事项
math.div() 仅在 Dart Sass 1.23.0+(对应 SCSS 6.0+)可用,Node Sass 已废弃且不支持。如果你还在用 node-sass,升级到 sass(Dart Sass)是硬性前提。
- 检查版本:
sass --version应输出类似1.70.0 - Webpack 用户需更新
sass-loader至 v14+,并确认implementation指向sass(非node-sass) - 旧代码批量替换建议用正则:
(\d+\.?\d*\w*)\s*\/\s*(\d+\.?\d*\w*)→ 手动审阅后改为math.div($1, $2),别全自动替——很多/是路径或字体简写
最易被忽略的是字体声明里的 /:像 font: 16px/1.5 "sans-serif" 完全不受影响,math.div() 和它无关——只动真正用于计算的地方。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











