前端项目开发阶段崩溃？试试这招“Node 内存扩容术”，立马复活！

背景

在使用Uniapp开发时，由于项目过大，开发阶段保存后热更新会出现内存溢出，项目崩溃的情况。本文主要介绍如何临时解决内存溢出问题，不影响开发阶段的开发过程。

1. 了解node的默认内存限制

Node.js的默认内存限制（即 V8 堆内存的默认最大值），是随着 Node.js 的版本、操作系统、以及是 32 位还是 64 位系统而有所不同的。

那么我们如何知道不同版本的内存限制是多少呢？如何查看你当前 Node.js 的默认堆内存限制？

我们可以通过使用 v8.getHeapStatistics().heap_size_limit来准确查看你当前运行的 Node.js 进程允许的最大堆内存是多少（单位是字节）。

1.1 验证方法（复制即用）：

创建一个文件 check-default-memory.js：

ini 复制代码

const v8 = require('v8');

const heapStats = v8.getHeapStatistics();

const maxHeapBytes = heapStats.heap_size_limit;
const maxHeapMB = Math.round(maxHeapBytes / (1024 * 1024));
const maxHeapGB = (maxHeapBytes / (1024 * 1024 * 1024)).toFixed(2);

console.log(`🔍 你当前 Node.js 的 V8 堆内存默认上限是：`);
console.log(`• ${maxHeapBytes.toLocaleString()} 字节`);
console.log(`• ${maxHeapMB} MB`);
console.log(`• ${maxHeapGB} GB`);

运行它：

sql 复制代码

node check-default-memory.js

你将看到类似如下输出：

markdown 复制代码

🔍 你当前 Node.js 的 V8 堆内存默认上限是：
• 2147483648 字节
• 2048 MB
• 2.00 GB

⚠️  提示：你当前可能运行在默认的 2GB 堆内存限制下，
    对于大型 UniApp 项目，建议手动设置更大的内存，比如 4GB 或 8GB。

⚠️ 注意： 这里的"默认堆内存限制"指的是 V8 的 --max-old-space-size的默认值，即 heap_size_limit的值 ，它是 JavaScript 堆（存放对象、闭包等）可用的最大内存，不包括 Node.js 自身使用的 C++ 层内存、Buffer、堆外内存等。

1.2 不同node版本的内存限制(mac)

这里使用的是mac进行测试，结果如下：

Node.js 版本	系统默认堆内存（约）
v10 及之前	~1.4GB ~ 1.7GB
v12	~2GB（2048MB）
v14 / v16 / v18 / v20	~4GB（4096MB）

node4版本：

node10版本：

node12版本：

node 14、16、18、20版本：

1.3 为什么不同 Node.js 版本的默认内存不一样？

V8 引擎在设计时对堆内存的使用是 有安全限制的，主要是为了：

防止某个 Node.js 进程占用过多系统内存，导致操作系统不稳定。
在早期，JavaScript 应用通常不需要使用几 GB 的内存，所以默认值较低。
32 位系统本身寻址空间有限（最大约 1~2GB），所以限制更小。
Node.js 官方默认保持保守，把更大的内存权限交给开发者手动配置。

那么如何扩大node的默认内存限制呢？

2. 如何手动设置node内存限制

为什么需要手动设置内存限制，因为默认的内存已经无法运行大型项目。例如：公司开发项目时，热更新超过4G就导致项目崩溃。

windows电脑开发截图:

手动设置内存为8G后，热更新最大内存占用为7G左右，满足开发需求:

2.1 临时设置（推荐）：

Windows（CMD/PowerShell）：

arduino 复制代码

set NODE_OPTIONS=--max-old-space-size=8000 && uni -p mp-weixin

macOS / Linux（bash/zsh）：
arduino 复制代码
```
NODE_OPTIONS=--max-old-space-size=8000 uni -p mp-weixin
```

注意mac和windows写法不同！

2.2 永久设置（可选不做具体介绍）：

在系统环境变量中添加：

arduino 复制代码

NODE_OPTIONS=--max-old-space-size=8000

3. 总结

最后总结一下：Node14后，默认的堆内存限制大都是是4GB。不足以支撑大型项目在开发阶段的热更新或编译，因此推荐手动通过 --max-old-space-size提升限制，比如设为8GB满足开发阶段的需求。

如有错误，请指正O^O!