vscode内存溢出90%非代码问题,而是extensionhost进程失控;需用developer: open process explorer查真实rss,严格配置files.watcherexclude排除node_modules/.venv/.git等目录,禁用插件后必须重启extensionhost或手动kill残留pid。

VSCode 运行代码时提示内存溢出,90% 不是你的 Python/JavaScript 代码在爆内存,而是 VSCode 自身的进程结构、监听机制和插件加载策略出了问题——尤其在大型项目里,extensionHost 进程卡在 500MB+ 不回落,基本可以确定是配置没关对,不是代码写错了。
怎么快速确认是不是 extensionHost 在吃内存
别猜,直接看真实占用:
- 按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),输入并运行Developer: Open Process Explorer - 展开
extensionHost节点,按Memory列从高到低排序 - 重点关注带具体项目路径(如
/home/user/myproject)的条目,不是“已启用”,而是“已加载并正在跑”的插件 - 如果某个插件空闲时 RSS 稳定在 >300MB,大概率存在缓存未释放或监听器没
dispose()
注意:Developer: Show Running Extensions 只给估算值,不准;Developer: Open Process Explorer 才是真实 RSS(物理内存),必须用它。
files.watcherExclude 配错等于没配
files.watcherExclude 是防止内存线性增长的底线配置,不是可选项。VSCode 默认用 chokidar 监听工作区所有子目录,node_modules 里几万个文件,每个都注册一个内核 inotify 句柄——这些句柄几乎不回收,内存只涨不跌。
- 必须写在项目根目录的
.vscode/settings.json,用户级设置在多工作区下 100% 失效 - 规则必须带双星号和尾部斜杠:
"**/node_modules/**": true✅,"**/node_modules": true❌(VSCode 忽略) - Python 项目至少加这四条:
"**/node_modules/**"、"**/.venv/**"、"**/venv/**"、"**/.git/**" - 用了 pnpm?补上
"**/node_modules/.pnpm/**": true;用了 turborepo?加上"**/.turbo/**": true
search.exclude 只影响搜索结果,完全不阻止监听器创建——它和 files.watcherExclude 不是一回事,别混用。
Python 项目里误配 typescript.tsserver.maxMemory 是白忙
typescript.tsserver.maxMemory 只对 TypeScript/JavaScript 语言服务生效,写在 Python 项目里完全无效,还可能让你误以为“已经调了”,从而忽略真正该动的参数。
- Python 类型分析靠的是
python.analysis.extraPaths和python.analysis.autoSearchPaths - 把
python.analysis.extraPaths指向整个venv/lib/python3.x/site-packages,Pylance 会强制解析成千上万个包,内存瞬间冲到 1.2GB+ - 正确做法:显式关闭自动扫描,只加必要路径:
{ "python.analysis.autoSearchPaths": false, "python.analysis.extraPaths": ["./src"], "python.defaultInterpreterPath": "./venv/bin/python" } - 大项目建议直接关掉全量类型检查:
"python.analysis.typeCheckingMode": "off",或换用更轻量的pylsp
禁用插件后内存不降?你没杀对进程
右键插件点 Disable (For All Folders) 只是标记状态,旧的 extensionHost 子进程还在跑,RSS 一毛不动。
- 禁用后必须运行
Developer: Restart Extension Host(不是“重载窗口”) - 如果重启后内存还是不降,说明有残留 PID,打开终端执行:
ps aux | grep "code" | grep "extensionHost"
找出对应 PID,手动kill -9 [PID] - GitLens、
esbenp.prettier-vscode、ms-python.python这三类插件最常驻留内存,优先查它们
真正难搞的不是某次峰值,而是空闲状态下 RSS 卡在高位不动——那说明对象没被 GC 回收,通常是因为事件监听没解绑、缓存没 clear()、或者 Webview 没销毁。这类问题不会因为你“换个主题”或“清个缓存”就消失。











