装完 ms-python.python 卡顿的根源是默认启用全套服务,应禁用 Pylance 改用 Jedi、关闭自动 lint/格式化、排除 venv 和 pycache 监视、停用终端自动激活,并指定绝对解释器路径。

装完 ms-python.python 就卡,不是你电脑不行,是它默认启用了全套服务——Pylance 语言服务器、自动 lint、格式化、终端自动激活、全量 site-packages 扫描,全在后台同步跑。关掉冗余项,卡顿立刻缓解。
禁用 Pylance 改用 Jedi(最立竿见影)
Pylance 在大型项目里会同步解析整个 site-packages,动辄占用 1.2GB 内存 + 启动超 5 秒。Jedi 虽弱于类型推导,但语法补全、跳转、基础提示完全够用,且内存常驻不到 200MB。
- 打开设置(
Cmd+, / Ctrl+,),搜索python.languageServer,值改为"Jedi" - 重启语言服务:按
Cmd+Shift+P / Ctrl+Shift+P→ 输入Python: Restart Language Server - 确认状态栏右下角显示
Jedi而非Pylance
关掉自动 lint 和格式化(避免保存时卡住)
多个 linter(如 pylint + flake8)或 formatter(black + autopep8)叠加执行,保存瞬间 CPU 爆表。VS Code 不会告诉你谁在抢资源,只让你等。
- 禁用所有 linter:
python.linting.enabled设为false - 只留一个 formatter:
python.formatting.provider设为"black"(或"autopep8"),其他 formatter 插件直接禁用 - 删掉或注释掉
python.linting.pylintEnabled、python.linting.flake8Enabled等开关项
排除 venv 和 __pycache__ 的文件监视(防止 Code Helper 持续飙高)
files.watcherExclude 必须配在工作区级 .vscode/settings.json,用户级设置对大项目无效。漏掉 venv 或 __pycache__,编辑器就当它们是代码目录持续监听,每生成一个 .pyc 文件都触发一次事件。
立即学习“Python免费学习笔记(深入)”;
- 添加以下内容到
.vscode/settings.json:
"files.watcherExclude": {
"**/node_modules/**": true,
"**/venv/**": true,
"**/env/**": true,
"**/__pycache__/**": true,
"**/.mypy_cache/**": true,
"**/.pytest_cache/**": true
}
\wsl$ 路径;Windows 用户请确认没把项目放在 OneDrive/iCloud 同步目录内停掉终端自动激活和冗余启动参数(解决点击绿色三角无响应)
每次开终端都执行 source venv/bin/activate 并扫描全部包(尤其含 torch、tensorflow),是终端启动慢、Command failed with exit code 9009 的主因。
- 将
python.terminal.launchArgs设为空数组:[] - 明确指定解释器路径:
python.defaultInterpreterPath填绝对路径(如/home/user/venv/bin/python),避免每次启动都查PATH - 禁用
python.terminal.executeInFileDir(默认true),防止它反复切换目录触发监听
真正卡住的点,往往不是“插件太多”,而是某个插件在后台默默做着同步、全量、递归的事——比如 Pylance 扫 site-packages、code-runner 调 shell 解析路径、watcher 盯着 venv 里的几千个 .pyc。这些动作不会报错,只会让 CPU 持续 >70%,而你只觉得“打字变慢了”。



















