Sass 1.65.0 起，内置 rem() 函数由单参数升级为双参数（需同时传入像素值和基准字体大小），旧代码如 rem(300) 将触发“2 arguments required”错误；本文详解原因、兼容方案及安全升级策略。
sass 1.65.0 起，内置 `rem()` 函数由单参数升级为双参数（需同时传入像素值和基准字体大小），旧代码如 `rem(300)` 将触发“2 arguments required”错误；本文详解原因、兼容方案及安全升级策略。
Sass 自 v1.65.0（2023年7月发布）起对内置函数 rem() 进行了语义强化：不再默认假设根元素字体大小为 16px，而是要求显式传入基准值（base font size），以提升跨项目、多主题场景下的可预测性与可维护性。因此，原写法：
.container {
width: rem(300); // ❌ SassError: 2 arguments required, but only 1 was passed.
}将立即报错，因为新版本 rem($px, $base: 16px) 强制要求两个参数。
✅ 正确用法（推荐 —— 显式、健壮、可读）
// 方式1：显式传入基准值（最清晰）
.container {
width: rem(300, 16px); // → 18.75rem
}
// 方式2：使用变量统一管理基准（适合多主题/动态字体场景）
$root-font-size: 16px; // 或从 CSS 自定义属性读取：clamp(14px, 1rem, 18px)
.container {
width: rem(300, $root-font-size);
}⚠️ 兼容性过渡方案（临时应急）
若项目中 rem() 调用密集且暂无法全面重构，可锁定 Sass 版本至 1.64.2（最后一个保留单参数 rem($px) 的稳定版）：
npm install sass@1.64.2 --save-dev # 或 yarn add sass@1.64.2 --dev
? 验证方式：运行 npx sass --version 确认输出为 1.64.2。注意：此为临时措施，长期建议迁移至双参数语法，以获得未来 Sass 功能更新与安全性支持。
? 不推荐的做法
- 覆盖内置 rem() 函数（如通过自定义函数重写）：易引发不可预知的副作用，且违背 Sass 官方设计意图；
- 依赖 node-sass：node-sass 已于 2021 年正式弃用（EOL），其不支持新版 Sass 语法与函数，应统一迁移到官方 Dart Sass（即 sass 包）。
? 最佳实践总结
| 场景 | 建议 |
|---|---|
| 新项目 / 重构中 | 直接采用 rem($px, $base) 双参数写法，配合 $root-font-size 变量集中管理 |
| 存量项目紧急修复 | 锁定 sass@1.64.2，并制定渐进式迁移计划 |
| 构建工具链检查 | 确保 sass-loader 与 sass 版本兼容（v12+ loader 推荐搭配 Sass v1.60+） |
| CI/CD 提示 | 在 package.json 中添加 resolutions（Yarn）或使用 overrides（npm >=8.3）强制统一 Sass 版本，避免依赖树冲突 |
✅ 最终验证：编译成功后，生成的 CSS 应正确输出为 width: 18.75rem;（当 $base: 16px 时），且无 Sass 编译警告或错误。
遵循上述方案，即可彻底解决 2 arguments required 报错，同时让样式系统更健壮、可维护，并与 Sass 官方演进路线保持同步。
