# 编译器内存溢出解决方案

## 问题描述
编译时出现 `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 硬盘
- 升级硬件配置