VS Code启动Python项目时后台分析致Python崩溃、内存过高如何解决？

这种后台分析时持续崩溃、占用大量内存的情况绝对不正常——正常情况下，Python扩展的后台分析只会占用少量系统资源，根本不会到崩溃的地步。下面是我整理的几个靠谱的解决步骤，你可以一步步试：

一、先排查扩展本身的问题 #

• 更新Python扩展到最新版本：老版本很可能存在内存泄漏或者分析逻辑的bug，打开VS Code的扩展面板（Ctrl+Shift+X），找到Microsoft Python扩展，点击更新按钮就行（如果有更新提示的话）。
• 禁用并重新启用扩展：有时候扩展的缓存会出问题，先禁用扩展，重启VS Code，再重新启用，说不定就能缓解问题。
• 试试预发布版本：如果最新稳定版还是不行，可以切换到预发布版——在扩展面板里找到Python扩展，点右上角的小齿轮，选择Install Pre-release Version，预发布版通常会包含一些针对这类问题的紧急修复。

二、调整后台分析的相关设置 #

VS Code的Python扩展有不少可以控制分析强度的设置，针对性调整能大幅降低资源占用：

• 关闭/弱化类型检查：打开设置（Ctrl+,），搜索python.analysis.typeCheckingMode，把它从strict或basic改成off——类型检查是后台分析最耗资源的部分，关闭后内存占用会骤降；如果还需要基础类型提示，改成basic也比strict省资源很多。
• 排除无关文件/文件夹：搜索python.analysis.exclude，把项目里的venv（虚拟环境）、__pycache__、node_modules这些不需要分析的文件夹加进去，避免扩展做无用功。
• 限制分析范围为当前打开文件：搜索python.analysis.diagnosticMode，改成openFilesOnly——这样扩展只会分析你正在编辑的文件，而不是扫描整个项目，内存压力会小很多。
• 关闭自动导入建议：搜索python.analysis.autoImportCompletions，把它关掉，这个功能也会增加后台分析的负担，不需要的话直接禁用就行。

三、清理缓存和冗余数据 #

• 删除Python扩展的缓存：找到VS Code的缓存目录，Windows一般是%APPDATA%\Code\User\workspaceStorage，Mac是~/Library/Application Support/Code/User/workspaceStorage，Linux是~/.config/Code/User/workspaceStorage，删掉和Python扩展相关的文件夹，然后重启VS Code。
• 重建虚拟环境：如果你的项目用了虚拟环境，有时候依赖包损坏或者版本冲突会导致分析异常。可以删掉现有虚拟环境，重新创建并安装依赖试试。

四、排查项目本身的问题 #

• 检查是否有超大文件：如果项目里有几百MB甚至GB级别的Python文件，后台分析肯定会崩溃，要么把这类文件移出去，要么拆分它。
• 排查第三方依赖：有些第三方包的代码结构复杂或者存在循环导入问题，会让分析器卡住。可以临时移除几个可疑的依赖，看看是否能恢复正常，逐步定位出问题包。

五、其他备选方案 #

• 切换到Jedi语言服务器：默认Python扩展用的是Pylance，如果问题一直存在，可以换成Jedi——打开设置，搜索python.languageServer，选择Jedi，它的资源占用相对低一些，虽然功能没Pylance全，但稳定性可能更好。
• 给VS Code加内存配额：如果你的机器内存不算大，可以修改VS Code的运行参数，让它能使用更多内存。打开命令面板（Ctrl+Shift+P），输入Preferences: Configure Runtime Arguments，在打开的argv.json里添加"--max-memory=4096"（数值根据你的内存调整，比如8G内存可以设为6144），然后重启VS Code。

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