--disable-gpu是唯一真正生效的方案，因其在VSCode启动早期通过命令行传入，直接禁用Chromium底层GPU渲染进程；改settings.json或GUI开关无效，因GPU进程已在配置加载前初始化完毕。
直接加 --disable-gpu 才真正生效
VSCode 启动黑屏，八成是 Electron 渲染进程在 GPU 合成阶段卡死，不是崩溃也不是安装损坏。改 settings.json 里的 "window.enableGPUAcceleration" 或点 GUI 设置里的「Hardware Acceleration」开关，全都不起作用——因为 GPU 进程在 settings 加载前就已初始化完毕。
唯一可靠路径：把 --disable-gpu 作为启动参数传入主进程。验证方法很简单：code --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
code --verbose 是定位深层问题的唯一入口
禁用 GPU 后仍白屏？或者想确认是不是驱动或环境导致的，必须看 code --verbose 输出。GUI 层不报错，但命令行会暴露渲染进程崩溃、模块缺失、权限拒绝等真实线索。
常见关键日志含义：
-
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 启动残留
别碰 argv.json 以外的配置文件
有人搜到 "disable-hardware-acceleration": true，试图写进 settings.json，结果无效——这个字段只在命令行参数中被解析，settings.json 完全不识别它。
唯一能通过配置文件控制的方式，是编辑 argv.json（路径：Windows %APPDATA%\Code\argv.json，macOS ~/Library/Application Support/Code/argv.json，Linux ~/.config/Code/argv.json），内容为纯 JSON 对象，例如：
{"disable-hardware-acceleration": true}
注意：argv.json 不是通用设置文件，它只影响启动参数，且必须是合法 JSON 格式（无注释、逗号结尾不能省）。改完需彻底退出所有 Code.exe / Code Helper 进程再重试。
扩展和用户数据目录才是隐藏雷区
有些环境（比如旧版 Intel 核显 + WSLg 或 Jetson 嵌入式平台）仅禁用 GPU 还不够，得组合排查：
- 先跑
code --disable-extensions --disable-gpu --verbose：若能进空窗口，说明某个扩展（尤其是含原生二进制的，如 C/C++、Python 插件）引发崩溃 - 临时换用户数据目录测试：
code --user-data-dir="/tmp/vscode-test" --disable-gpu；若正常，原User Data目录里的Cache或GPUCache子目录大概率已损坏 - Linux 上部分发行版（如 Ubuntu）还需额外加
--no-sandbox，尤其在容器或嵌入式环境；但切记不要长期以 root 运行，避免配置权限错乱
真正麻烦的从来不是参数本身，而是你改了快捷方式却忘了杀干净后台进程，或是只改了桌面文件里的一个 Exec= 而漏掉右键菜单里的另一个启动入口——这些细节一漏，黑屏就会在你最意想不到的时候复现。
