VSCode打不开90%是配置、扩展或缓存问题,非软件损坏;应依次检查扩展(code --disable-extensions)、settings.json语法、workspaceStorage/globalStorage缓存、系统干扰(杀软/GPU/权限/路径),多数5分钟内可解决。

VSCode打不开,90%不是软件坏了,而是某处配置、扩展或缓存卡住了启动流程。别急着重装——先按顺序做这四类检查,绝大多数问题5分钟内就能定位。
用 code --disable-extensions 快速验证是否是扩展惹的祸
很多崩溃都藏在后台悄悄加载的扩展里,比如 Python、Pylance、Remote-SSH 或某个新装的主题。安全模式能绕过所有扩展初始化,是最高效的“减法排查”。
- 打开终端(Windows 用 PowerShell/CMD,macOS/Linux 用 Terminal),输入:
code --disable-extensions
- 如果此时能正常打开,说明问题一定出在扩展上
- 接着在 VSCode 中按
Ctrl+Shift+P→ 输入并执行Developer: Show Running Extensions,重点关注 “Startup” 列为Yes的扩展 - 逐个禁用它们(右键 →
Disable (Global)),每次禁用后完全退出 VSCode 再重启测试 - 也可改用
code --verbose启动,终端输出里报错的那一行常直接带扩展名,比如Failed to activate extension 'ms-python.python'
检查 settings.json 是否存在格式错误
一个多余的逗号、引号不闭合、key 写错大小写,都会让 VSCode 在解析阶段静默失败——窗口不弹、进程不报错,只看到图标转圈后消失。
- 关闭所有 VSCode 进程(包括系统托盘里的)
- 找到用户配置目录:
Windows:%APPDATA%\Code\User\
macOS:~/Library/Application Support/Code/User/
Linux:~/.config/Code/User/ - 把
settings.json重命名为settings.json.bak,再启动 VSCode - 如果恢复了,就说明原文件有语法问题;可用 JSON 校验工具(如 jsonlint.com)粘贴内容检查,或对比备份逐步还原
- 同理可试
keybindings.json或整个User文件夹重命名
清空 workspaceStorage 和 globalStorage 缓存
这两个文件夹保存项目状态和扩展数据,非正常退出后极易损坏,导致 VSCode 卡在“正在加载工作区”或根本不动。
- 路径同上,在用户配置目录的上一级(即
%APPDATA%\Code\或~/.config/Code/)中找到:User/workspaceStorage和User/globalStorage - 直接删除或重命名这两个文件夹(例如改为
workspaceStorage.bak) - 更彻底的验证方式:用全新用户目录启动,跳过所有旧数据:
Windows:code --user-data-dir="%TEMP%\vscode-test"
macOS/Linux:code --user-data-dir=/tmp/vscode-test
- 若这样能启动,说明原用户数据已损坏;可迁移必要配置(如 snippets、keybindings)后重建
留意系统级干扰:杀软、GPU、权限与路径
有些问题不报错、不崩溃,但会让 VSCode 停在某个后台任务上,表面看就是“卡住不动”。这类问题往往被忽略,却高频发生。
- 国产杀毒软件(如 360、腾讯电脑管家)可能静默拦截
Code.exe创建子进程,临时退出杀软再试 - 远程桌面、老旧显卡或虚拟机环境下,GPU 渲染容易冲突,加参数启动:
code --disable-gpu
- Windows 用户右键 VSCode 图标 → “属性” → “兼容性” → 勾选
以管理员身份运行,尤其当提示“临时文件夹权限不足”时有效 - 确保安装路径、项目路径不含中文、空格或特殊符号;某些扩展(如 Conda 相关)扫描路径异常也会拖慢启动
- 如果报错含
ffmpeg.dll找不到,大概率是安装包损坏,直接去官网下载最新稳定版重装即可——该 DLL 是 VSCode 自带的,不在系统路径里
最常被跳过的其实是第一步:检查任务管理器里有没有残留的 Code.exe 进程。有时候只是界面卡死,结束进程再双击图标就恢复了——这种“没动静”,往往根本不需要动配置或重装。










