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）和启动参数要协同，否则只是把问题从“白屏”推到“间歇性渲染撕裂”。