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%CodeUsersettings.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% scode-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 把环境打回干净状态，再一层层加回来——这才是最省时间的路径。
