使用npx create-react-app创建项目报JavaScript heap out of memory错误
问题根因
从报错日志可明确核心错误为JavaScript heap out of memory(JavaScript堆内存不足),触发问题的原因有两个:
- Node.js默认分配的堆内存上限无法满足当前create-react-app的安装依赖需求
- 你当前使用的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
相关产品推荐
相关产品推荐

