VSCode启动卡顿或崩溃多因扩展或设置损坏,可禁用扩展排查;用户数据目录损坏需重命名重建;备份应仅保留扩展清单、工作区设置等关键文件,避免复制缓存目录。
多数情况是扩展或用户设置损坏导致的。先尝试禁用所有扩展启动:code --disable-extensions(Windows/macOS/Linux 均适用)。如果此时能正常打开,说明问题出在某个扩展上。
常见诱因包括:
GitLens 在 Git 仓库路径异常时会阻塞主进程Settings Sync 扩展在登录失效或 token 过期时反复重试,造成界面无响应settings.json 中存在非法 JSON(如末尾多逗号、未闭合引号)会导致 VSCode 拒绝加载配置,但不报错,只显示空白窗口优先检查是否被系统安全策略拦截,尤其是 macOS 上的 Gatekeeper 或 Windows 的 SmartScreen。右键应用 → “显示简介” → 勾选“仍要打开”;Windows 下可尝试以管理员身份运行 code --verbose 查看控制台输出。
更可能的原因是用户数据目录损坏:
%APPDATA%\Code
~/Library/Application Support/Code
~/.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 是二进制临时文件,不仅体积大,还可能引发下次启动失败。
这是 VSCode 1.85+ 版本依赖的 Visual C++ 运行库缺失所致,不是 VSCode 自身问题。必须安装 Microsoft Visual C++ 2015–2025 Redistributable (x64),仅装 2015 或 2019 版本不够。
验证方式:
where vcruntime140_1.dll,应返回 C:\Windows\System32\vcruntime140_1.dl
l
vc_redist.x64.exe 并完整安装装完后无需重启系统,但需关闭所有 VSCode 进程(任务管理器里杀掉 Code.exe 及其子进程),再重新启动。
真正麻烦的不是启动失败,而是误删 User 目录下 globalStorage 里的内容——某些扩展(比如 Python、Remote - SSH)把环境缓存、SSH 主机密钥、conda 路径映射全放这儿,删了就得重配,而且不会提醒你。