直接调大 Node.js 堆内存上限是最有效、最常用的解决方式，尤其适用于 TypeScript 项目在 Vite 全量构建时触发内存错误的场景；推荐通过 NODE_OPTIONS 环境变量设置 --max-old-space-size（如 4096），并配合 tsconfig 优化、依赖精简与构建配置调优。
直接调大 Node.js 堆内存上限是最有效、最常用的解决方式，尤其适用于 TypeScript 项目在 Vite 全量构建（vite build）时触发 FATAL ERROR: Ineffective mark-compacts 或 JavaScript heap out of memory 的场景。
设置 NODE_OPTIONS 环境变量（推荐）
这是最干净、可复用的方案，避免每次手动加参数。在项目根目录的 package.json 中修改构建脚本：
-
Linux/macOS：使用
export或直接前置变量
"build": "NODE_OPTIONS=--max-old-space-size=4096 vite build"
}
-
Windows（CMD）：用
set命令（注意等号前后无空格）
"build": "set NODE_OPTIONS=--max-old-space-size=4096 && vite build"
}
-
Windows（PowerShell）：需用
$env:语法
"build": "npm run build:ps",
"build:ps": "powershell -Command \"$env:NODE_OPTIONS='--max-old-space-size=4096'; vite build\""
}
数值建议从 4096（4GB）起步；若仍失败，可尝试 6144 或 8192，但不建议无限制上调——需结合机器物理内存判断（例如 16GB 内存设备，设到 6GB 较稳妥）。
优化 TypeScript 编译路径（降低内存压力）
Vite 默认用 esbuild 快速转译 TS，但某些复杂类型或大量 node_modules 类型声明仍会加重内存负担。关键配置点：
- 确保
tsconfig.json中启用"noEmit": true—— 这让 Vite 跳过生成 .js 文件，仅做类型检查（由单独的tsc --noEmit或 IDE 承担），大幅减少构建时内存占用 - 排除非源码目录：
"exclude": ["node_modules", "dist", "coverage"] - 禁用不必要的类型检查：
"skipLibCheck": true（尤其对含大量第三方类型定义的项目） - 避免
typeRoots或types过度引入全局类型包
精简依赖预构建与 Rollup 处理
TypeScript 项目常因依赖多、类型复杂导致预构建阶段内存飙升。针对性调整：
- 显式控制
optimizeDeps范围，只预构建真正需要的模块：
optimizeDeps: {
include: ['vue', 'vue-router', 'pinia', 'axios'],
exclude: ['@types/*'] // 避免预构建类型包
}
})
- 关闭生产环境 source map（
build.sourcemap: false），TS 源码映射是内存大户 - 若使用
rollupOptions.manualChunks，避免把整个node_modules打成一个 chunk；按库名拆分（如lodash-es、date-fns单独 chunk），减少单次处理对象数
验证与监控实际内存使用
别只靠报错才调参。构建前加一行诊断命令，观察真实水位：
"build:mem": "node -e \"console.log('Heap used:', Math.round(process.memoryUsage().heapUsed / 1024 / 1024), 'MB')\" && vite build"也可在构建脚本中插入：
"build": "NODE_OPTIONS=--max-old-space-size=4096 node -e \"console.log('[MEM] Starting build...')\" && vite build"配合 process.memoryUsage() 输出，能帮你判断当前设置是否冗余或不足。
