--disable-gpu是唯一真正生效的方案，因其在VSCode启动早期通过命令行传入，直接禁用Chromium底层GPU渲染进程；改settings.json或GUI开关无效，因GPU进程已在配置加载前初始化完毕。
VSCode 启动后界面异常（黑屏、白屏、窗口空白、对话框不弹出、菜单栏消失等），绝大多数不是软件损坏，而是 GPU 渲染冲突、扩展阻塞或用户数据目录损坏导致的——禁用 GPU 加速通常 5 秒内就能验证是否有效。
启动后黑屏/白屏但进程在运行？先试 --disable-gpu
这是最常见原因：Electron 渲染进程卡在 GPU 合成阶段，尤其在 Intel 核显、远程桌面、多显示器高 DPI 场景下高频触发。任务管理器能看到 Code.exe（Windows）或 code（macOS/Linux）持续占用 CPU，但主窗口无内容。
- 临时验证：终端运行
code --disable-gpu，能立刻出现空窗口就基本锁定 GPU 问题 - 永久生效不能改
settings.json—— VSCode 不识别"disable-hardware-acceleration"这类配置，必须改启动方式 - Windows：右键快捷方式 → “属性” → 在“目标”末尾加空格再加
--disable-gpu - macOS：用
open -n -a "Visual Studio Code" --args --disable-gpu；如需固定 Dock 启动，用 Automator 打包为 App - Linux：修改
/usr/share/applications/vscode.desktop，把Exec=code改成Exec=code --disable-gpu
code --status 卡在某个扩展名？优先怀疑含原生模块的插件
运行 code --status 后输出停在 Activating extension 'ms-python.python' 或类似行，说明该扩展初始化阻塞了主线程。这类问题多见于依赖 node-gyp 编译二进制的插件（Python、Prettier、ESLint、GitLens 等）。
- 先用
code --disable-extensions --disable-gpu --verbose启动，确认是否恢复 - 若恢复，逐个禁用最近更新/安装的扩展：重命名其文件夹（如
~/.vscode/extensions/ms-python.python-2024.12.1→...bak），再重启验证 - 别长期用
--disable-extensions：它跳过所有activationEvents，语言服务器、调试器等核心功能不会自动加载 - 部分插件（如 Codex）还依赖环境变量（
HTTP_PROXY、ulimit），GNOME 桌面启动时可能未继承，需用包装脚本启动
对话框不弹出（文件选择、设置窗口、Git 提交框）？检查 GPU 和焦点拦截
这类问题常被误判为“功能失效”，实则是渲染层或系统级干扰：GPU 渲染崩溃导致 dialog API 无法挂载 DOM，或全屏应用（如 Zoom、游戏）、DPI 缩放不兼容、窗口管理器拦截了新窗口焦点。
- 先运行
code --no-sandbox --disable-extensions --disable-gpu，排除沙盒与插件干扰 - 打开开发者工具（
Help → Toggle Developer Tools），切换到 Console 标签页，搜索dialog.showOpenDialog或showMessageBox是否报错 - 若看到
Failed to create EGL context（Linux）或SecKeychainCopyDefault: -25293（macOS），属底层图形/安全框架初始化失败，非插件问题 - GNOME 或 KDE 下可尝试
code --force-renderer-accessibility强制启用辅助功能通道，绕过部分窗口焦点策略
用户数据目录损坏？别直接删整个 User Data 目录
VSCode 的 User Data 目录存了扩展状态、窗口布局、缓存快照等运行时关键数据。其中 Cache 和 GPUCache 子目录二进制损坏是高频原因，会导致无限重启循环（刚点开就退出，进程频繁启停）。
- 临时验证：用干净路径启动，如
code --user-data-dir="/tmp/vscode-test"（Linux/macOS）或code --user-data-dir="C:\vscode-test"（Windows） - 若能正常打开，说明原目录损坏；此时不要直接复制旧
Cache或GPUCache过去 - 可安全迁移的只有：
settings.json、keybindings.json、snippets/、extensions/（不含子目录里的node_modules） - Windows 默认路径：
%APPDATA%\Code\User Data；macOS：~/Library/Application Support/Code/User Data；Linux：~/.config/Code/User Data
真正难定位的是组合问题：比如 GPU 加速异常 + 某个扩展的原生模块在低 ulimit 下初始化失败 + GNOME 未继承代理环境。这时候单靠一个参数很难解决，得按顺序隔离——先保 GUI 出来，再逐步放开扩展、GPU、同步、代理，每步都用 code --verbose 看日志输出停在哪一行。
