VSCode启动白屏或黑屏是GPU渲染异常所致，需同时添加--disable-gpu和--disable-gpu-compositing参数；Linux Wayland用户还需加--ozone-platform=wayland。
VSCode 启动后白屏或黑屏，大概率是 GPU 渲染异常
这不是 VSCode 崩溃，也不是插件冲突，而是 Electron 渲染进程在初始化 GPU 加速时失败，回退机制又没及时启用软件渲染，导致窗口内容无法绘制。常见于更新显卡驱动、切换显示器、连接远程桌面或使用某些 Linux 桌面环境（如 Wayland + NVIDIA）之后。
--disable-gpu 和 --disable-gpu-compositing 参数必须同时加才有效
单独加 --disable-gpu 在新版 Electron（VSCode 1.80+ 使用的版本）中已不足以绕过所有 GPU 路径；--disable-gpu-compositing 才能真正禁用合成器层面的 GPU 调用。两者缺一不可。
- Windows：右键快捷方式 → “属性” → 在“目标”末尾追加：
--disable-gpu --disable-gpu-compositing -
macOS：终端启动时加参数：
open -n -a "Visual Studio Code" --args --disable-gpu --disable-gpu-compositing - Linux：命令行启动加参数：
code --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 - 若用桌面快捷方式，需修改
.desktop文件中的Exec=行，确保参数完整
显卡驱动未更新或存在冲突时，白屏可能伴随 GL_INVALID_OPERATION 日志
VSCode 启动时按 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools，切换到 Console 标签页，常能看到类似错误：
WebGL: INVALID_OPERATION: useProgram: program not valid glUseProgram: Program has compile/link errors. [.WebGL-0x7f8b4c0a2c00] GL_INVALID_OPERATION
这说明驱动返回了无效的 OpenGL 上下文。此时：
- NVIDIA 用户：确认安装的是官方驱动（非 Nouveau），且版本 ≥ 525（推荐 535+）
- Intel 核显用户：Linux 下建议升级到 Mesa ≥ 23.2，旧版对 Vulkan 后端支持不稳
- 可临时用
--use-gl=swiftshader强制使用软件 OpenGL 实现（性能低但稳定）
真正麻烦的不是白屏本身，而是很多人试了 --disable-gpu 就以为搞定，结果发现编辑器偶尔卡死或滚动掉帧——那是因为合成器仍在尝试用 GPU，只是没完全失败。参数必须配齐，环境变量（如 LIBGL_ALWAYS_SOFTWARE=1）和启动参数要协同，否则只是把问题从“白屏”推到“间歇性渲染撕裂”。
