VSCode启动卡顿或崩溃多因扩展或设置损坏,可禁用扩展排查;用户数据目录损坏需重命名重建;备份应仅保留扩展清单、工作区设置等关键文件,避免复制缓存目录。

VSCode 启动卡在空白窗口或直接崩溃
多数情况是扩展或用户设置损坏导致的。先尝试禁用所有扩展启动:code --disable-extensions(Windows/macOS/Linux 均适用)。如果此时能正常打开,说明问题出在某个扩展上。
常见诱因包括:
-
GitLens在 Git 仓库路径异常时会阻塞主进程 -
Settings Sync扩展在登录失效或 token 过期时反复重试,造成界面无响应 - 自定义
settings.json中存在非法 JSON(如末尾多逗号、未闭合引号)会导致 VSCode 拒绝加载配置,但不报错,只显示空白窗口
VSCode 完全无法启动(双击无反应 / 终端执行无输出)
优先检查是否被系统安全策略拦截,尤其是 macOS 上的 Gatekeeper 或 Windows 的 SmartScreen。右键应用 → “显示简介” → 勾选“仍要打开”;Windows 下可尝试以管理员身份运行 code --verbose 查看控制台输出。
更可能的原因是用户数据目录损坏:
- Windows:
%APPDATA%\Code - macOS:
~/Library/Application Support/Code - Linux:
~/.config/Code
临时重命名该目录(如加 _backup 后缀),再启动 VSCode —— 它会重建默认配置。若成功,说明原目录中 Cache、GPUCache 或 Local Storage 存在损坏文件。
如何安全备份当前工作区与扩展列表
即使 VSCode 打不开,所有用户数据都还在磁盘上。关键是要区分「可恢复」和「不可替代」的内容:
- 扩展本身可重装,但启用状态和配置需手动还原 → 运行
code --list-extensions --show-versions > extensions.txt备份已安装扩展清单 - 工作区设置(
.vscode/settings.json)和代码片段(snippets/)必须从项目目录或用户数据目录中手动拷贝 -
keybindings.json和tasks.json通常位于Code/User/下,不要遗漏
注意:不要直接复制整个 Code 目录来“备份”,其中 Cache 和 GPUCache 是二进制临时文件,不仅体积大,还可能引发下次启动失败。
Windows 下遇到“找不到 VCRUNTIME140_1.dll”错误
这是 VSCode 1.85+ 版本依赖的 Visual C++ 运行库缺失所致,不是 VSCode 自身问题。必须安装 Microsoft Visual C++ 2015–2022 Redistributable (x64),仅装 2015 或 2019 版本不够。
验证方式:
- 打开命令提示符,执行
where vcruntime140_1.dll,应返回C:\Windows\System32\vcruntime140_1.dll - 若无返回,去微软官网下载最新
vc_redist.x64.exe并完整安装
装完后无需重启系统,但需关闭所有 VSCode 进程(任务管理器里杀掉 Code.exe 及其子进程),再重新启动。
真正麻烦的不是启动失败,而是误删 User 目录下 globalStorage 里的内容——某些扩展(比如 Python、Remote - SSH)把环境缓存、SSH 主机密钥、conda 路径映射全放这儿,删了就得重配,而且不会提醒你。










