--disable-gpu是唯一真正生效的方案，因其在VSCode启动早期通过命令行传入，直接禁用Chromium底层GPU渲染进程；改settings.json或GUI开关无效，因GPU进程已在配置加载前初始化完毕。
--disable-gpu 是唯一真正生效的启动参数，其他所有配置方式（包括 settings.json、GUI 开关、argv.json 以外的任何修改）全部无效。 因为 GPU 渲染进程在 VSCode 加载用户配置前就已初始化完毕，改设置根本来不及干预。
为什么改 settings.json 或 GUI 设置没用
很多人搜到 "window.enableGPUAcceleration" 或 "editor.disableGPUAcceleration"，设为 true 或 false 后重启，黑屏照旧。这不是操作错误，而是 VSCode 根本不通过这些配置项控制底层 Chromium 的 GPU 渲染管线。"editor.disableGPUAcceleration" 只影响编辑器区域的局部加速，对主窗口、侧边栏、状态栏等 Shell 级渲染完全无感。GUI 里的「Hardware Acceleration」开关同理——它只管动画和窗口过渡，不管 GPU 合成。
真正起效的只有命令行参数：--disable-gpu（全局禁用）或更彻底的 --disable-hardware-acceleration（连字体光栅化都走 CPU）。这两个参数必须在主进程启动时传入，否则等于没说。
Windows/macOS/Linux 各平台怎么加参数才永久生效
不能靠改配置文件，得改启动入口：
- Windows：右键快捷方式 → “属性” → 在“目标”末尾加空格再加
--disable-gpu；路径含空格必须用英文双引号包裹，例如："C:\Program Files\Microsoft VS Code\Code.exe" --disable-gpu - macOS：终端运行
open -n -a "Visual Studio Code" --args --disable-gpu；如需固定 Dock 启动，必须用 Automator 封装成 App 并嵌入该命令 - Linux：修改
~/.local/share/applications/code.desktop（优先改用户级），确保所有Exec=行（包括[Desktop Action]段落里的）都追加--disable-gpu
注意：argv.json 是唯一能从配置文件角度控制的方式（路径：Windows %APPDATA%\Code\argv.json，macOS ~/Library/Application Support/Code/argv.json，Linux ~/.config/Code/argv.json），但它的内容格式是 JSON 数组，不是 key-value 对，写错一个逗号就失效。
禁用 GPU 后还白屏？必须看 code --verbose 输出
GUI 层不报错，但命令行会暴露真实线索。运行 code --verbose --disable-gpu，重点盯以下几类日志：
-
Failed to load module "canberra-gtk-module"（Linux）：缺声音支持库，sudo apt install libcanberra-gtk3-module -
libEGL initialization failed或Failed to create EGL context：底层图形栈初始化失败，大概率显卡驱动不兼容 -
ERROR:gpu_process_host.cc(1207)（Windows）：明确指向 GPU 进程异常，建议更新 WHQL 认证驱动 -
Unable to read file '/user-data-dir/Cache/' (Error: EACCES)：用户数据目录权限错误，常见于手动迁移或 sudo 启动残留
如果日志里出现 GL_INVALID_OPERATION 或 WebGL 相关错误，说明驱动返回了无效 OpenGL 上下文——NVIDIA 用户请确认驱动 ≥ 535，Intel 核显用户建议在控制面板中强制指定高性能处理器，而非“自动选择”。
新版 Electron（VSCode 1.80+）需要额外加 --disable-gpu-compositing
单加 --disable-gpu 在新版本中已不够。Electron 渲染层拆分了 GPU 初始化和合成阶段，仅禁用前者，后者仍可能卡死。必须同时加：
code --disable-gpu --disable-gpu-compositing
Linux Wayland 用户还要额外加 --ozone-platform=wayland，否则 VSCode 默认走 X11 兼容路径，极易白屏。验证当前会话是否为 Wayland：echo $XDG_SESSION_TYPE 输出 wayland 即适用。
最常被忽略的是：WSLg 窗口、vscode:// 链接、code . 命令，它们都复用主进程的启动参数。若主 VSCode 没配好，这些场景全都会复现黑屏——尤其 WSLg 下 GUI 渲染对 GPU 更敏感。
