--disable-gpu是唯一真正生效的禁用gpu加速方案，因vscode基于electron，gpu进程在settings.json和gui设置加载前即初始化完毕；其他所有配置方式均无法干预底层渲染管线。
--disable-gpu 是唯一真正起效的启动参数，其他所有设置方式（包括 GUI 开关、settings.json 修改）都无效——因为 GPU 渲染进程在配置加载前就已初始化完毕。
为什么改 settings.json 或点开关没用？
VSCode 的 "window.enableGPUAcceleration": false 或 GUI 里「Hardware Acceleration」关闭选项，只影响部分 UI 动画或编辑器区域，不触达主窗口、侧边栏、状态栏等 Shell 级渲染。更关键的是：disable-hardware-acceleration 这个参数名本身只被命令行解析器识别，settings.json 根本不读它。
怎么永久加 --disable-gpu 参数？
必须让该参数在主进程启动时传入，不同系统操作方式不同：
- 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
禁用 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启动残留
新版 VSCode（1.80+）可能需要额外参数
仅加 --disable-gpu 在某些环境下仍不够。Electron 升级后，合成器层（compositor）会绕过该开关继续尝试 GPU 调用：
- 必须同时加上
--disable-gpu-compositing才能彻底禁用 GPU 合成 - Linux Wayland 用户还需额外加
--ozone-platform=wayland，否则即使禁用 GPU 也可能白屏 - 验证命令示例：
code --disable-gpu --disable-gpu-compositing --ozone-platform=wayland
code --disable-gpu 能立刻恢复界面，就不要再花时间调设置或重装——那是方向性错误。
