VSCode黑屏大概率是GPU渲染崩溃，终端运行code --disable-gpu可快速验证；永久生效需在快捷方式或别名中添加该参数，settings.json中相关配置无效。
显卡驱动导致黑屏：先关 GPU 加速再验证
VSCode 启动后窗口全黑、光标可动但无界面，大概率是 GPU 渲染崩溃——尤其在集成显卡（Intel UHD、AMD Radeon Vega）、老旧独显或远程桌面环境下。这不是 VSCode 崩溃，而是它尝试用硬件加速画 UI 时被显卡驱动拖垮了。
- 最快速验证：终端运行
code --disable-gpu，如果立刻正常显示，基本锁定 GPU 问题 - 永久生效：在快捷方式目标栏末尾添加该参数（Windows）；macOS/Linux 可写别名
alias code='code --disable-gpu' - 注意：禁用 GPU 后文本渲染略软、滚动稍卡，但功能完全不受影响；不是性能退化，而是绕过一个已知不稳定的渲染路径
settings.json 里禁用硬件加速无效？那是配置项写错了
很多人在设置里搜 “gpu” 找到 "editor.disableGPUAcceleration" 并设为 true，结果重启还是黑屏——因为这个配置项只控制编辑器区域的 GPU 加速，对主窗口、侧边栏、状态栏等 Shell 级渲染无效。
- 真正起效的是启动参数：
--disable-gpu（全局禁用）或--disable-hardware-acceleration（更彻底，连字体光栅化都走 CPU） -
"disable-hardware-acceleration": true是命令行参数的 JSON 化写法，**不能**直接写进settings.json；它只在通过code --disable-hardware-acceleration启动时由 VSCode 解析 - 若必须从配置文件控制，唯一可靠方式是修改快捷方式或 shell 别名，而非依赖用户设置
NVIDIA/AMD 控制面板里“自动选择显卡”反而会害你
很多笔记本用户开了 NVIDIA Optimus 或 AMD Switchable Graphics，默认把 VSCode 分配给集显——但 VSCode 的 Electron 渲染引擎在某些集显驱动版本下会触发 OpenGL 上下文创建失败，直接黑屏。
- 进 NVIDIA 控制面板 → “管理 3D 设置” → “程序设置”，添加
Code.exe，指定使用“高性能 NVIDIA 处理器” - AMD Radeon 设置 → “图形” → “可切换图形应用程序设置”，同样添加
Code.exe并设为“高性能” - 不要选“自动选择”或“省电模式”；哪怕你用的是核显本，也建议强制指定独显（即使没独显，该操作本身无副作用）
- 改完需**完全退出 VSCode 进程**（任务管理器里杀掉所有
Code.exe和Code Helper），再重新启动
驱动更新后反而黑屏？回滚比重装更稳妥
显卡驱动更新（尤其是 Intel DCH 驱动或 NVIDIA Game Ready 驱动）常引入新的 WebGL 兼容性 bug，导致 VSCode 黑屏。这时候重装 VSCode 没用，得动驱动本身。
- Windows：设备管理器 → 显示适配器 → 右键显卡 → “属性” → “驱动程序” → “回退驱动程序”（仅限 10 天内更新过）
- 手动下载旧版驱动：Intel 用户去Intel Driver & Support Assistant 拉历史版本；NVIDIA 用户在Driver Downloads 页面点“Previous Drivers”
- 别迷信“最新即最好”——VSCode 官方推荐驱动版本通常滞后于厂商发布，稳定压倒一切
真正麻烦的不是黑屏本身，而是误判成软件损坏去重装、清配置、删插件，结果白忙半天。显卡驱动问题有非常典型的症状和路径：黑屏但进程存活、--disable-gpu 立竿见影、远程桌面必现、更新后突发——抓住这几点，三分钟就能定位。
