最直接有效的办法是调高 Node.js 的堆内存上限，因 Vite 构建（依赖预构建、Rollup 打包、esbuild 运行）易突破默认 1.4–2GB 限制；需配合 ARM64 原生依赖、精简预构建、系统级调优（如 hosts 修复、文件描述符扩容）才能彻底解决卡顿与内存溢出问题。
最直接有效的办法是调高 Node.js 的堆内存上限，因为 Vite 构建（尤其是依赖预构建和 Rollup 打包）会大量加载模块、解析 AST、运行 esbuild，很容易突破默认的 1.4–2GB 限制。其他手段需配合使用，否则容易治标不治本。
调整 Node.js 堆内存大小
这是绝大多数情况下的首选方案，操作简单、见效快：
- 在 package.json 的
scripts中修改构建命令，例如："build": "node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build"
其中6144表示 6GB，可根据项目规模设为 4096（4GB）、8192（8GB）甚至更高 - Windows 用户可用环境变量方式：
"build": "set NODE_OPTIONS=--max-old-space-size=6144 && vite build" - macOS/Linux 用户推荐：
"build": "NODE_OPTIONS=--max-old-space-size=6144 vite build" - 避免全局设置
NODE_OPTIONS，防止影响其他 Node 工具链
确保 ARM64 架构下原生二进制运行（M 系列芯片必查）
在 macOS M1/M2/M3 上，若 esbuild、sharp 或 fsevents 是 x86 架构的二进制，Node 运行时会静默降级或反复尝试兼容，大幅拖慢构建并推高内存占用：
- 检查 Node 架构：
node -p process.arch→ 应输出arm64 - 检查 npm 架构：
npm config get arch→ 若为x64，执行npm config set arch arm64 - 彻底清理重装：
rm -rf node_modules package-lock.json && npm install，全程在原生终端（非 Rosetta）中操作 - 验证 esbuild：
npx esbuild --version不报错，且which esbuild指向node_modules/.bin/esbuild下的 ARM64 可执行文件
精简构建过程中的内存压力点
单纯加内存只是兜底，真正降低峰值占用需从构建链路入手：
立即学习“Java免费学习笔记（深入）”；
-
优化依赖预构建：在
vite.config.ts中显式排除大而慢的依赖，例如：optimizeDeps: { exclude: ['@unocss/preset-icons', 'monaco-editor'] } -
禁用非必要插件：如
@unocss/preset-icons在 v0.47.1–v0.47.3 存在已知 OOM 问题，回退到 v0.46.x 可直接解决 -
拆分大型资源：避免单个组件内嵌数 MB 图片或 JSON；静态资源改用
public/目录直引，跳过打包流程 -
控制动态导入范围：不用
import.meta.glob('./locales/*.json')一次性加载全部语言包，改用按需import()或后端接口获取
辅助性系统级调优（尤其 macOS）
一些看似无关的系统配置，实际会显著拉长构建耗时、间接加剧内存堆积：
- 修复
localhost解析延迟：在/etc/hosts中确认有127.0.0.1 localhost，避免 DNS 查询阻塞 dev server 启动 - 增大文件描述符限制（macOS）：
sudo sysctl -w kern.maxfiles=65536和ulimit -n 65536，防止 watch 失效引发重复编译 - 关闭不必要的后台进程，特别是占用大量内存的 Electron 应用或 Docker 实例
