Mac平台Eslint解析挂起且内存耗尽问题求助

问题场景 #

在macOS 13.2.1（16GB内存）环境下，本地运行ESLint时遇到以下异常：

• 首次解析阶段直接挂起，终端执行DEBUG=eslint:*,eslintrc:* npx eslint --fix apps/**/*.ts时，进程卡在仅9行代码的someFile.app.ts文件解析步骤
• VS Code中ESLint插件崩溃，输出提示JavaScript堆内存耗尽
• 流水线环境无此问题，仅本地终端和VS Code无法正常使用

环境信息：

• eslint: ^8.40.0
• node: v16.20.0（nvm 0.39.3管理）

排查与解决步骤 #

1. 临时提升Node内存限制
   跑ESLint时手动给Node分配更大堆内存，比如：

   NODE_OPTIONS="--max-old-space-size=8192" DEBUG=eslint:*,eslintrc:* npx eslint --fix apps/**/*.ts
   

   VS Code里也可以给ESLint插件加内存，修改settings.json：

   "eslint.nodePath": "~/.nvm/versions/node/v16.20.0/bin/node",
   "eslint.runtimeArgs": ["--max-old-space-size=8192"]
   

2. 检查ESLint配置的冗余/冲突规则

   • 排查.eslintrc系列配置文件，看是否存在规则嵌套循环、过度启用重型规则（比如@typescript-eslint/no-unused-vars配合复杂类型检查、import/no-cycle深度扫描）
   • 先临时禁用所有规则，再逐步启用，定位是哪个规则触发内存溢出

3. 缩小扫描范围，排除无关文件

   • 确认apps/**/*.ts是否误扫了node_modules、构建产物这类文件，在.eslintignore中添加排除项：

     node_modules/
     dist/
     build/
     

   • 直接指定单个文件测试：npx eslint --fix apps/path/to/someFile.app.ts，看是否仍挂起

4. 检查TypeScript配置与依赖兼容性

   • 确认tsconfig.json的include/exclude是否合理，避免ESLint加载过多不必要的类型定义
   • 检查@typescript-eslint/eslint-plugin、@typescript-eslint/parser版本是否与eslint@8.40.0兼容（建议保持同版本区间）

5. 清理缓存与重置依赖

   • 清理ESLint缓存：npx eslint --clear-cache
   • 删除node_modules和锁文件后重新安装：

     rm -rf node_modules package-lock.json
     npm install
     

6. 尝试调整Node/ESLint版本

   • 临时切换到Node 18版本测试（nvm use 18），排除Node 16的内存管理特定问题
   • 降级ESLint到8.39.0或升级到最新稳定版，排查是否为版本特定bug

内容的提问来源于stack exchange，提问作者FabioCosta