解决 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 进程的内存限制,您可以有效解决由于内存不足导致的构建失败问题,确保项目的顺利构建和部署。

相关推荐
ZhengEnCi11 小时前
Express 企业级项目结构怎么组织:五层骨架、单向依赖和一份能跑的边界检查脚本
javascript·node.js·express
Dumbness13 小时前
搜 platform 却给出 Form 表单:离线文档检索把短关键词当成了子串
javascript·node.js
用户216076340831 天前
一个 2 MB 的 .zst 文件,解压出来只有十几 KB
node.js
oil欧哟2 天前
Oil Studio 的产品思路与日常使用方式:在 Mac 上录口播演示,并接入 AI Agent 精剪与自动录屏
人工智能·macos
木头左3 天前
【浏览器自动化】用 CDP 接管本机 Chrome:从一个宿主迁到另一个宿主的设计与踩坑
node.js·浏览器自动化·cdp·技能化·踩坑实践
小毛球.3 天前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
cpolar技术支持3 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper4 天前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
CodeClimb5 天前
Mac 磁盘无法推出(DMG外接盘)排查处理教程
macos
木头左5 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化