当你从同事那里复制了一个体积巨大的源码文件，Codex缓慢加载了几圈后，突然完全卡死。终端中弹出一行红色报错：FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - Ja vaScript heap out of memory。看到这条信息，基本可以判定：Node.js运行时的可用内存已经耗尽，进程被系统强制终止。

别担心，这个问题有解决办法。而且不只是临时缓解，而是一套能够稳定处理超过50MB源码文件的完整操作指南。

确认当前是32位还是64位运行环境

这一步必须提前完成。无论你的物理内存是16GB还是64GB，如果Codex以32位模式启动，它的堆内存上限永远被限制在3.2GB左右——再怎么优化也无济于事。

先检查一下：打开终端，运行 codex --version --verbose。观察输出中是否有 arch: x64。如果看到的是 arch: ia32 或者没有这项信息，那么你确实在使用32位模式。

不同操作系统的处理方式略有不同：

对于Windows用户，右键点击Codex快捷方式，选择“属性”，进入“兼容性”选项卡，取消勾选“以兼容模式运行这个程序”，然后点击“更改高DPI设置”，勾选“替代高DPI缩放行为”并选择“系统(增强)”，最后点击应用。这些步骤会强制系统使用64位加载器。

macOS/Linux用户，在终端运行 file $(which codex)。返回结果如果包含 Mach-O 64-bit x86_64 executable 或 ELF 64-bit LSB pie executable，才算符合要求。否则，请重新安装最新64位版本。

强制提升Node.js堆内存上限

Codex基于Node.js运行，而Node.js默认的堆内存限制仅为约1.4GB，远远不足以处理大文件。必须手动增加老生代空间。

临时方案（适合调试时使用）：启动Codex之前，在终端输入 NODE_OPTIONS="--max-old-space-size=6144" codex。这里的6144代表6GB。建议设置成物理内存的50%～75%，但不要超过12288（12GB），否则可能导致系统不稳定。

永久方案（推荐长期使用）：找到Codex的启动脚本。Windows上通常是codex.exe同级目录下的codex.bat，macOS/Linux上是codex这个可执行文件。在首行插入对应的环境变量设置：Windows用 @set NODE_OPTIONS=--max-old-space-size=6144，macOS/Linux用 export NODE_OPTIONS="--max-old-space-size=6144"。

有一点必须注意：修改之后，一定要完全退出所有Codex进程再重启。旧进程不会自动继承新参数。

禁用非必要索引与预加载

很多时候，内存溢出的真正原因并非文件本身，而是Codex在后台自动构建语义索引。它会试图将整个文件的AST一次性加载到内存中，而不是采用流式解析——这才是问题的根源。

第一步：关闭实时补全。打开Codex设置 → Editor → Completions → 关闭 Enable AI completions 和 Auto-suggest on typing。

第二步：限制索引范围。进入 Settings → Indexing → File size limit (MB)，把默认的10改成2。这样Codex会跳过所有超过2MB的文件索引，仅保留符号跳转的基础能力。

第三步：排除冗余路径。在 Settings → Indexing → Exclude patterns 中添加：**/node_modules/**, **/dist/**, **/build/**, **/*.min.js, **/*.log。这一步能够立即减少80%以上的无效文件扫描，索引器不会再误入那些庞大的打包产物。

启用流式解析降级模式

如果上述方法都尝试过后，单个超大文件（例如超过100MB的SQL dump或日志文件）仍然不够稳定，那么不要再勉强——放弃语义分析，改用纯文本流式查看。

操作很简单：在Codex中打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并选择 Codex: Open Large File in Plain Mode，然后选中目标文件。Codex会跳过AST构建，直接以只读分页方式加载，内存占用始终保持在100MB以下。

在这个模式下，全文搜索（Ctrl+F）、正则高亮、行号跳转都仍然可用，只是函数跳转、变量引用追踪和代码补全这类AI功能会失效。对于纯粹审阅类型的任务而言，已经足够使用了。