VS Code 启动卡顿或空白窗口的 GPU 排查

部分显卡或驱动环境可能与 VS Code 使用的硬件加速不兼容,表现为启动卡住、界面空白或无法正常渲染。

临时验证

先从命令行禁用 GPU 启动:

code --disable-gpu

如果这样能够正常打开,问题可能与 GPU 硬件加速有关。--disable-gpu 是诊断和临时绕过方式,不建议在没有相关问题时使用。

持久配置

  1. Ctrl+Shift+P 打开命令面板。
  2. 运行 Preferences: Configure Runtime Arguments,中文界面通常显示为“首选项:配置运行时参数”。
  3. 在打开的 argv.json 中加入:
{
  "disable-hardware-acceleration": true
}
  1. 完全退出并重新启动 VS Code。

如果 argv.json 已有其他配置,只添加对应字段,并注意保留合法 JSON 语法。

恢复默认

删除 disable-hardware-acceleration 字段并重启 VS Code。恢复后如果问题再次出现,可继续检查显卡驱动、VS Code 版本和窗口日志。

参考资料