改NODE_OPTIONS能快速绕过内存溢出，因Node.js v14及更早版本默认堆内存仅约1.4 GB，而Dart Sass解析大量@import或sass-resources-loader重复注入时极易触顶；v8.0+支持通过export NODE_OPTIONS="--max-old-space-size=4096"扩限，但需显式配置。
为什么改 NODE_OPTIONS 能快速绕过内存溢出
Node.js 默认堆内存限制在 v14 及更早版本中约 1.4 GB，而 Dart Sass 或 node-sass 在解析大量 @import、嵌套层级深、或被 sass-resources-loader 强制重复注入时，AST 构建和字符串拼接极易触顶。v8.0+ 支持通过环境变量扩限，但不是所有构建环境都自动继承该配置。
-
export NODE_OPTIONS="--max-old-space-size=4096"（Linux/macOS） -
set NODE_OPTIONS=--max-old-space-size=4096（Windows CMD） - 若用 npm script，推荐写成：
"build:css": "cross-env NODE_OPTIONS=--max-old-space-size=4096 sass src/main.scss dist/main.css" - v16+ 默认堆上限已升至 ~2 GB，但若项目含自定义 Webpack loader（如旧版
sass-resources-loader），仍可能触发溢出
sass-resources-loader 是怎么把内存吃光的
它会把指定 SCSS 文件（如 variables.scss）强制注入到每个被编译的 SCSS 模块顶部——相当于每编译一个文件，就完整重解析一遍全部变量和 mixin。当注入文件超过 5 个，内存占用呈线性增长，而非常数级。
- 典型错误现象：
FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory - 排查方法：临时注释掉 webpack 配置中
sass-resources-loader的use项，再跑一次编译，看是否消失 - 替代方案：Webpack 5+ 改用
sassOptions.additionalData注入极简变量文件；Vite 用户应避免在css.preprocessorOptions.scss.additionalData中注入含@import的内容 - 真正安全的注入方式：只在入口
main.scss里@use "variables" as var，不带任何样式规则
为什么 @use 能根治内存膨胀
@import 是纯文本拼接，哪怕只调用一个 px2rem(12)，也会把整个 _utils.scss（含未用的 @mixin clearfix、几十个变量）全塞进输出；@use 则按需加载，只引入被引用的部分，并加命名空间隔离。
- 必须用 Dart Sass ≥1.23.0；
node-sass已废弃，不支持@use -
@use "colors" as color后，必须写color.$primary，不能直接写$primary - 第三方库（如 Bootstrap 5）若未切
@use，可暂时混用，但加载顺序要明确：先@use自己模块，再@import第三方 - 迁移可用
sass-migrator module --verbose自动改写，手改易漏@forward和命名空间
压缩模式 --style=compressed 为什么救不了内存问题
它只删空格、换行、注释和冗余分号，不做逻辑优化：不合并重复声明、不剔除未用选择器、不折叠相同属性块。内存压力来自编译阶段的 AST 和中间字符串，不是最终 CSS 大小。
立即学习“前端免费学习笔记（深入）”；
- 开
--source-map会让 base64 字符串追加到 CSS 末尾，体积暴增 +100 KB+，且与--style=compressed冲突 - Webpack 项目中，
sourceMap: false必须写在css.loaderOptions.sass下，不是顶层配置 - Vite 用户注意：
css.devSourcemap默认为true，上线构建前务必关掉 - 真正瘦身靠模块拆分 +
@use+ 砍掉聚合式@import "base/all"—— 这些动作直接影响编译时内存峰值
实际项目里最常被忽略的点是：你以为在优化输出 CSS，其实瓶颈卡在编译器解析阶段；@import 和 sass-resources-loader 是隐性放大器，它们让单次编译变成 N 次全量解析。改 NODE_OPTIONS 只是给救护车，砍掉冗余导入才是做手术。
