VSCode启动黑屏或白屏主因是GPU加速异常或渲染进程崩溃，非配置文件损坏；应优先执行code --disable-gpu --disable-extensions验证，若正常则说明问题源于显卡驱动兼容性或扩展干扰，后续可逐个启用扩展排查或永久添加启动参数。
VSCode 启动卡在黑屏或白屏
多数情况是渲染进程崩溃或 GPU 加速异常，不是配置文件损坏。先别急着删 settings.json 或重装。
尝试强制禁用 GPU 加速启动：
Windows/macOS/Linux 统一在终端执行：
code --disable-gpu --disable-extensions
如果此时能正常打开，说明问题出在显卡驱动兼容性或某个扩展的渲染干扰。后续可逐个启用扩展排查，或永久添加启动参数到快捷方式（Windows）或别名（macOS/Linux）。
VSCode 打开后无限加载「正在加载工作区」
常见于工作区含大文件夹、符号链接环、或远程 WSL/SSH 连接未就绪。VSCode 本身没报错，但状态栏一直转圈。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Developer: Toggle Developer Tools，切换到 Console 标签页，看是否有ENOTDIR、EACCES或connection refused类错误 - 检查
.vscode/settings.json中是否误配了"files.watcherExclude"导致监听器卡死；删掉该字段试试 - 临时关闭文件监视：在设置中搜索
files.useExperimentalFileWatcher，设为false；或启动时加参数--no-file-watchers
VSCode 启动后窗口空白，但进程存在
这是典型的 Electron 渲染线程冻结，尤其多见于 macOS M 系列芯片 + Rosetta 混合运行、或 Windows 上杀毒软件 hook 了 code.exe。
直接杀掉所有 VSCode 进程后，用以下方式干净重启：
code --no-sandbox --disable-extensions --disable-gpu
若仍无效，检查是否启用了「GPU 进程隔离」类安全策略（如某些企业版 McAfee/Carbon Black）。临时退出这类软件再试。不要依赖「重新安装」——VSCode 的用户数据（~/.vscode 或 %USERPROFILE%\AppData\Roaming\Code）通常完好，重装不解决根本问题。
恢复被破坏的用户设置或扩展状态
别直接覆盖整个 User 目录。VSCode 的配置分三层：默认 → 用户 → 工作区。异常往往只污染用户层。
- 定位用户配置目录：
Windows：%APPDATA%\Code\User
macOS：~/Library/Application Support/Code/User
Linux：~/.config/Code/User - 重命名
settings.json为settings.json.bak，再启动 VSCode —— 它会生成一份干净的默认配置 - 扩展没丢：已安装扩展保存在
Extensions子目录，只要不删整个User文件夹，重装 VSCode 后扩展会自动恢复（前提是登录了 VS Code 账户并开启了同步）
真正难恢复的是自定义 keybindings 和 snippets —— 它们也存在 User 目录下，备份习惯比事后抢救更可靠。
