You need to enable JavaScript to run this app. 使用npx create-react-app创建项目报JavaScript heap out of memory错误
优惠活动
大模型
产品
解决方案
定价
更多

使用npx create-react-app创建项目报JavaScript heap out of memory错误

问题根因

从报错日志可明确核心错误为JavaScript heap out of memory(JavaScript堆内存不足),触发问题的原因有两个:

  1. Node.js默认分配的堆内存上限无法满足当前create-react-app的安装依赖需求
  2. 你当前使用的Node.js 12.2.0与npm 7.20.0存在版本不兼容问题,额外拉高了安装过程的内存消耗
解决方案

按优先级从高到低排列:

  • 方案1:升级Node.js到适配的LTS版本(长期有效,最推荐)
    npm 7.x系列官方要求适配Node.js 14.x及以上版本,版本不匹配会导致各类安装异常。直接下载安装16.x LTS或18.x LTS版本的Node.js,安装完成后执行以下命令即可正常创建项目:
npm cache clean --force
npx create-react-app assessment
  • 方案2:临时提升Node.js堆内存上限
    如果暂时不能升级Node版本,可以先手动调整堆内存分配上限后再执行创建命令:
    Windows CMD环境执行:
set NODE_OPTIONS=--max-old-space-size=4096
npx create-react-app assessment

Windows PowerShell环境执行:

$env:NODE_OPTIONS="--max-old-space-size=4096"
npx create-react-app assessment

参数4096代表分配4GB内存,你可根据设备实际内存配置调整为2048(2GB)或8192(8GB)。

  • 方案3:更换包管理器创建项目
    也可以切换为pnpm或yarn作为包管理器,绕过npm的内存占用问题:
    使用pnpm:
npm install -g pnpm
pnpm create react-app assessment

使用yarn:

npm install -g yarn
yarn create react-app assessment

内容的提问来源于stack exchange,提问作者Pratik XV

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 15:42:00