VSCode 启动闪退或卡空白窗口，90% 是扩展、配置错误或缓存损坏所致；应优先执行 code --disable-extensions 验证，再检查 settings.json 语法、清理 workspaceStorage/globalStorage 或用 --user-data-dir 启动新环境定位。

VSCode 启动报错后直接闪退或卡在空白窗口，大概率不是软件损坏，而是某个扩展、配置项或缓存文件在初始化阶段触发了未捕获异常——这类问题 90% 可通过禁用扩展 + 清理配置快速定位，不用重装。

用 code --disable-extensions 验证是否是扩展惹的祸

这是最高效的第一步。很多崩溃发生在扩展激活阶段（比如 Pylance 加载 Python 类型索引失败、Remote-SSH 尝试连接已断开的主机），VSCode 会静默终止启动流程，不弹窗、不报错，只留下一个消失的进程。

• 完全退出 VSCode（Windows 检查任务管理器里是否有 Code.exe，macOS 查活动监视器中的 Electron 进程）
• 终端执行：

  code --disable-extensions

• 若能正常打开，说明问题出在扩展；此时可打开命令面板（Ctrl+Shift+P），运行 Developer: Show Running Extensions，重点关注 Startup 列为 Yes 的扩展（如 ms-python.python、esbenp.prettier-vscode）
• 逐个禁用这些扩展后重启，比“全关再一个个开”更快锁定源头

检查 settings.json 是否存在语法错误

一个多余的逗号、一个未闭合的字符串、一个非法的布尔值（比如写成 true 而非 true），都会让 VSCode 在解析用户配置时 panic 并退出。它不会提示“JSON 格式错误”，只会静默失败。

• 路径位置：
  Windows：%APPDATA%\Code\User\settings.json
  macOS：~/Library/Application Support/Code/User/settings.json
  Linux：~/.config/Code/User/settings.json
• 关闭所有 VSCode 进程，把 settings.json 重命名为 settings.json.bak
• 再运行 code 启动，若恢复，就说明原文件有误；可用 JSONLint 网站或 VSCode 自身（用其他编辑器打开该文件并启用 JSON 语法检查）验证修复
• 同理可临时重命名 keybindings.json 或整个 User 文件夹做隔离测试

清理 workspaceStorage 和 globalStorage 缓存

这两个目录保存了每个工作区的状态快照和扩展持久化数据，一旦因异常退出、磁盘满或权限变更而损坏，VSCode 会在加载时卡死或报 EBUSY: resource busy or locked 类错误（尤其在公司定制杀软环境下常见）。

• 它们位于用户配置目录同级：User/workspaceStorage 和 User/globalStorage
• 直接删除或重命名这两个文件夹（如改为 workspaceStorage.bak）即可，VSCode 下次启动会重建
• 更彻底的验证方式：用全新用户目录启动，跳过所有旧缓存：
  Windows：

  code --user-data-dir="%TEMP%\vscode-test"

  macOS/Linux：

  code --user-data-dir="/tmp/vscode-test"

  若能启动，说明原 User 目录已污染，可考虑迁移必要配置后重建

留意杀软、GPU 和远程开发残留干扰

某些国产安全软件（尤其是企业定制版）会拦截 Code.exe 创建命名管道（\\.\pipe\）或访问 node_modules，导致终端无法启动或扩展激活失败；GPU 渲染在远程桌面或老旧显卡上也容易引发黑屏/卡死。

• 临时退出杀毒软件再试，确认是否拦截；若属实，需在杀软白名单中添加 Code.exe 及其子进程
• 加参数启动排除 GPU 问题：

  code --disable-gpu

• Remote-SSH 连接异常未清理干净时，可能残留 ~/.vscode-server 中损坏的服务进程，直接登录远程机执行：

  rm -rf ~/.vscode-server

  再重连
• 注意路径含中文、空格或符号（如 C:\我的项目\）也可能触发 Node.js 底层路径解析异常，尽量使用纯英文路径

真正难排查的，往往是多个因素叠加：比如杀软拦截了某扩展的网络请求，该扩展又没做超时兜底，结果整个扩展主机（ExtensionHost）卡死，进而拖垮主进程。所以别卡在“为什么这个扩展突然不行”，先用 --disable-extensions 和 --user-data-dir 把环境打回干净状态，再一层层加回来——这才是最省时间的路径。