VSCode 1.80+ 启动白屏需同时添加 --disable-gpu 和 --disable-gpu-compositing 参数，仅 --disable-gpu 不足以禁用合成器GPU调用；Wayland用户还需指定 --ozone-platform=wayland。
VSCode 启动白屏，不是缺插件、不是 settings.json 写错，而是 GPU 渲染链路卡死——必须在进程启动时传参绕过，--disable-gpu 单独用已不够，新版 Electron（VSCode ≥1.80）要求配齐 --disable-gpu-compositing 才真正生效。
为什么 --disable-gpu 单独加了还白屏
VSCode 1.80+ 基于 Chromium 120+，GPU 初始化路径拆得更细：--disable-gpu 只停掉基础 GPU 调用，但合成器（compositor）仍会尝试用 GPU 合成图层。一旦驱动返回 GL_INVALID_OPERATION 或上下文创建失败，合成器就静默挂起，窗口留白。
- 现象：菜单栏能点、
Ctrl+Shift+P有反应，但编辑区/侧边栏全白 - 验证方式：终端运行
code --disable-gpu --verbose，看日志里是否还有gpu_process_host.cc相关错误 - 正确做法：必须同时加
--disable-gpu --disable-gpu-compositing，两者缺一不可
Linux Wayland 用户必须加 --ozone-platform=wayland
VSCode 默认在 Wayland 会话里仍走 X11 兼容路径，容易触发渲染线程阻塞。即使禁用了 GPU，不指定 Ozone 平台，照样白屏。
- 先确认环境：
echo $XDG_SESSION_TYPE输出wayland才适用 - 正确命令：
code --disable-gpu --disable-gpu-compositing --ozone-platform=wayland - 桌面快捷方式需改
/usr/share/applications/code.desktop中的Exec=行，确保参数完整 - 若用 NVIDIA 驱动，还需确认版本 ≥535，旧版对 Vulkan 后端支持不稳
Windows/macOS 永久生效别改 settings.json
"disable-hardware-acceleration": true 这类配置写进 settings.json 完全无效——VSCode 不读这个字段，它只响应启动时传入的 Chromium 命令行参数。
- Windows：右键快捷方式 → 属性 → “目标”末尾加空格再加
--disable-gpu --disable-gpu-compositing - macOS：终端执行
open -n -a "Visual Studio Code" --args --disable-gpu --disable-gpu-compositing；如需固定 Dock 启动，用 Automator 封装为 App - 别信“重装 VSCode”——用户数据目录缓存（
%APPDATA%\Code\Cache或~/Library/Caches/com.microsoft.VSCode）损坏才会持续白屏，删掉再试比重装快得多
白屏但控制台报 Failed to setup Skia Gr context
这常见于 WSLg、Jetson NX 或 Flutter 开发场景，本质是 OpenGL 上下文初始化失败，和桌面版白屏同源但触发路径不同。
- WSLg 用户：必须加
--disable-gpu --disable-gpu-compositing，且确保LIBGL_ALWAYS_SOFTWARE=1环境变量已设 - Jetson NX 等嵌入式平台：需额外加
--no-sandbox（注意不是--disable-sandbox），否则沙箱拦截 GPU 初始化 - Flutter 调试白屏：在
launch.json的args里加"--enable-software-rendering"，不是全局参数
真正麻烦的不是白屏本身，而是很多人加了 --disable-gpu 就以为搞定，结果滚动卡顿、菜单弹出延迟——那是因为合成器还在后台挣扎。参数必须配齐，环境变量和启动参数要协同，否则只是把问题从“全白”推到“半残”。
