解决 macOS (M1 Pro) 上使用 Vite 进行 Build 打包时 Node 进程内存溢出的问题

解决 macOS (M1 Pro) 上使用 Vite 进行 Build 打包时 Node 进程内存溢出的问题

在搭载 M1 Pro 芯片的 macOS 系统上,使用 Vite 进行项目构建(build)时,您可能会遇到 Node 进程内存溢出的错误。特别是在使用较新版本的 Node.js(如 Node 20)时,这个问题更为常见。

错误信息:
复制代码
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory

该错误表明当前 Node.js 进程尝试分配的内存量超出了其默认限制,这通常发生在处理大型项目或执行需要大量内存的操作时。

解决方案:

为了临时增加 Node.js 进程的最大旧空间大小(max-old-space-size),可以通过设置 NODE_OPTIONS 环境变量来实现。以下是如何操作的具体步骤:

  1. 临时解决方案

    在开始构建之前,通过命令行设置环境变量:

    sh 复制代码
    export NODE_OPTIONS="--max-old-space-size=8192"

    此命令将 Node.js 的最大旧空间大小增加到 8GB。完成上述设置后,运行您的构建命令:

    sh 复制代码
    yarn build

    使用这种方法,您可以临时增加 Node.js 进程可用的内存。请注意,当关闭当前终端会话时,此设置将自动失效。

  2. 永久解决方案

    如果希望永久更改此设置,可以在您的 shell 配置文件中添加相应的环境变量。对于使用 Bash 的用户,请编辑 ~/.bashrc 文件,并加入如下行:

    sh 复制代码
    export NODE_OPTIONS="--max-old-space-size=8192"

    对于使用 Zsh 的用户,则需要编辑 ~/.zshrc 文件并添加相同的行。保存文件后,请记得重新加载配置文件或重启终端以使更改生效。

通过调整 Node.js 进程的内存限制,您可以有效解决由于内存不足导致的构建失败问题,确保项目的顺利构建和部署。

相关推荐
名字不要太长 像我这样就好4 小时前
【iOS】OC源码阅读——alloc源码分析
笔记·学习·macos·ios·objective-c
刘婉晴8 小时前
【环境配置】Mac电脑安装运行R语言教程 2025年
开发语言·macos·r语言
zhishishe9 小时前
如何修复卡在恢复模式下的 iPhone:简短指南
windows·macos·ios·objective-c·cocoa·iphone
codingandsleeping9 小时前
Express入门
javascript·后端·node.js
Icoolkj10 小时前
在 Windows 系统上升级 Node.js
windows·node.js
想睡好12 小时前
以太网的mac帧格式
网络·macos
终码一生12 小时前
Mac桌面幻灯片,Google文档,google硬盘和google等图标如何移除
macos
只可远观14 小时前
Mac搭建Flutter IOS环境详细指南
前端·flutter·macos·ios
一牛14 小时前
译:Swift中的隔离机制介绍
macos·ios·swift
前端付豪15 小时前
3、Node.js异步编程彻底吃透
前端·后端·node.js