WebStorm 里运行 Node.js 项目卡顿，通常是因为 Node 进程默认堆内存受限导致频繁 GC，建议在运行配置中增加 V8 引擎的堆内存参数，而不是调整 IDE 本身的内存。
先说结论：优先区分是 IDE 界面卡还是 Node 进程卡，确认是后者后，在 Run Configuration 中追加内存参数。
- 先定位：观察卡顿发生时是 IDE 界面无响应，还是后端接口响应变慢或进程崩溃。
- 先做：在 WebStorm 运行配置文件的 Node parameters 栏位添加
`--max-old-space-size`=4096参数。 - 再验证：重启运行配置，通过代码打印内存上限或监控系统 GC 频率是否改善。
配置步骤（WebStorm 2023.2）
不需要修改全局环境变量，直接在 WebStorm 的运行配置里临时追加参数即可生效。
- 点击顶部菜单栏 Run，选择 Edit Configurations...。
- 在左侧列表找到当前 Node.js 的运行配置项。
- 找到 Node parameters 输入框。
- 输入
`--max-old-space-size`=4096，若有多个参数用空格隔开。 - 点击 OK 保存，重新运行项目。
注意：如果找不到 Node parameters 栏位，可以在 Environment variables 中添加NODE_OPTIONS=`--max-old-space-size`=4096。
如何验证内存限制已生效
重启服务后，可通过以下两种方式确认配置是否生效：
1. 代码验证：在项目入口文件添加以下监控代码，观察控制台输出的堆内存上限（heapTotal）是否接近设定值。
setInterval(() => {
const used = process.memoryUsage().heapUsed / 1024 / 1024;
const total = process.memoryUsage().heapTotal / 1024 / 1024;
console.log(`当前堆内存：${used.toFixed(2)} MB / 上限：${total.toFixed(2)} MB`);
}, 5000);2. 工具验证：打开 Chrome DevTools Memory 面板，查看 Heap 上限是否提升。若之前出现 JavaScript heap out of memory 报错，确认该报错不再出现。
不同机器内存设置建议
- 8GB 物理内存：建议设置为 2048 (MB)，预留足够空间给系统和 IDE。
- 16GB 及以上：可设置为 4096 (MB) 或更高，但不应超过物理内存剩余量的 50%。
常见坑与风险
- 混淆 IDE 内存与 Node 内存：修改 webstorm64.exe.vmoptions 只能缓解 IDE 界面卡顿，对 Node 子进程的内存瓶颈无帮助。
- 参数数值过大：设置的堆内存不能超过物理内存剩余量，否则会导致系统使用 Swap 交换分区，反而更卡。
- 配置未保存：修改后务必点击 OK 应用，有时默认配置被锁定，需要复制一份新配置再修改。
- 格式错误：参数中不要包含反引号（`）或引号，直接填写纯文本参数。