139 lines
4.1 KiB
Markdown
139 lines
4.1 KiB
Markdown
# 编译器内存溢出解决方案
|
||
|
||
## 问题描述
|
||
编译时出现 `FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory` 错误，表示 Node.js 内存不足。
|
||
|
||
## 解决方案
|
||
|
||
### 方案一：增加 Node.js 内存限制（推荐）
|
||
|
||
#### 在 HBuilderX 中设置
|
||
|
||
1. **修改 HBuilderX 配置文件**
|
||
- 关闭 HBuilderX
|
||
- 找到 HBuilderX 安装目录
|
||
- 打开 `HBuilderX\plugins\node\node_modules\@dcloudio\vite-plugin-uni\dist` 目录
|
||
- 或者在项目根目录创建 `vue.config.js` 文件
|
||
|
||
2. **创建或修改项目根目录下的 `vue.config.js`**
|
||
```javascript
|
||
module.exports = {
|
||
transpileDependencies: [],
|
||
// 增加 Node.js 内存限制
|
||
configureWebpack: {
|
||
devServer: {
|
||
disableHostCheck: true
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
3. **修改 HBuilderX 启动配置**
|
||
- 找到 HBuilderX 安装目录
|
||
- 编辑 `HBuilderX.exe` 的启动参数
|
||
- 创建一个批处理文件 `start-hbuilderx.bat`：
|
||
```bat
|
||
@echo off
|
||
set NODE_OPTIONS=--max-old-space-size=8192
|
||
start "" "HBuilderX安装路径\HBuilderX.exe"
|
||
```
|
||
- 将内存设置为 8GB（8192MB），可根据实际情况调整为 4096、8192 或更大
|
||
|
||
#### 在命令行中运行（如果使用 CLI）
|
||
|
||
如果您使用命令行方式编译，可以设置环境变量：
|
||
|
||
**Windows PowerShell：**
|
||
```powershell
|
||
$env:NODE_OPTIONS="--max-old-space-size=8192"
|
||
```
|
||
|
||
**Windows CMD：**
|
||
```cmd
|
||
set NODE_OPTIONS=--max-old-space-size=8192
|
||
```
|
||
|
||
**永久设置（Windows 系统环境变量）：**
|
||
1. 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
|
||
2. 在"用户变量"或"系统变量"中新建变量：
|
||
- 变量名：`NODE_OPTIONS`
|
||
- 变量值：`--max-old-space-size=8192`
|
||
3. 重启 HBuilderX
|
||
|
||
### 方案二：清理缓存
|
||
|
||
1. **清理 HBuilderX 缓存**
|
||
- 在 HBuilderX 中：运行 → 清理项目缓存
|
||
- 或者手动删除 `unpackage` 目录
|
||
|
||
2. **删除 node_modules 并重新安装**
|
||
```powershell
|
||
Remove-Item -Recurse -Force node_modules
|
||
# 如果有 package.json，重新安装依赖
|
||
npm install
|
||
```
|
||
|
||
### 方案三：优化项目
|
||
|
||
1. **检查大文件**
|
||
- 检查 `static` 目录下是否有过大的图片或资源文件
|
||
- 当前项目中有 85 个 icon 图片，建议：
|
||
- 压缩图片文件
|
||
- 使用雪碧图或字体图标代替多个小图标
|
||
- 将不常用的资源移到云存储
|
||
|
||
2. **检查第三方库**
|
||
- 检查 `lib` 目录中的第三方库是否必需
|
||
- 当前已引入的库：
|
||
- dompurify@3.2.4es.js
|
||
- markdown-it.min.js
|
||
- highlight-uni.min.js
|
||
- lunar-javascript@1.7.2.js
|
||
- string-similarity.min.js
|
||
- 考虑按需引入或延迟加载
|
||
|
||
3. **优化编译配置**
|
||
在 `manifest.json` 中的 `h5.optimization` 已启用 `treeShaking`，这很好。
|
||
|
||
4. **分包加载**
|
||
- 已使用 `packageA` 分包，继续保持
|
||
- 考虑将更多页面移到分包中
|
||
|
||
### 方案四：升级 HBuilderX
|
||
|
||
确保使用最新版本的 HBuilderX，新版本通常有更好的内存管理。
|
||
|
||
## 推荐操作步骤
|
||
|
||
1. **立即执行：** 设置 `NODE_OPTIONS` 环境变量为 `--max-old-space-size=8192`
|
||
2. **清理缓存：** 在 HBuilderX 中清理项目缓存
|
||
3. **重启 HBuilderX：** 使用新的环境变量启动
|
||
4. **长期优化：** 压缩静态资源，优化第三方库引入
|
||
|
||
## 验证
|
||
|
||
设置完成后，重新编译项目，查看是否还会出现内存溢出错误。
|
||
|
||
## 参考资料
|
||
|
||
- [uni-app 官方文档 - 内存溢出问题](https://uniapp.dcloud.net.cn/tutorial/run/OOM.html)
|
||
- Node.js 内存限制说明：
|
||
- 默认限制：约 1.4GB（32位）或 1.7GB（64位）
|
||
- 建议设置：4096MB（4GB）或 8192MB（8GB）
|
||
- 最大可设置：取决于系统可用内存
|
||
|
||
## 常见问题
|
||
|
||
**Q: 设置后仍然内存溢出？**
|
||
A: 尝试增大内存限制值，如 `--max-old-space-size=16384`（16GB）
|
||
|
||
**Q: 如何检查当前 Node.js 内存限制？**
|
||
A: 在命令行运行：`node -e "console.log(require('v8').getHeapStatistics().heap_size_limit/(1024*1024))"`
|
||
|
||
**Q: 编译特别慢？**
|
||
A: 内存充足但编译慢，可能是 CPU 性能问题，考虑：
|
||
- 关闭不必要的后台程序
|
||
- 使用 SSD 硬盘
|
||
- 升级硬件配置
|
||
|