--disable-gpu必须从命令行启动时传入才生效；因vscode基于electron，gpu进程在settings.json加载前已初始化，运行时设置无效，且需彻底终止旧进程、路径加引号、统一所有启动入口参数。

直接加 --disable-gpu 参数启动，是唯一真正生效的方案；改设置、改 settings.json 或点 GUI 里的「Hardware Acceleration」开关，全都不起作用。

为什么 --disable-gpu 必须从命令行加

VSCode 底层用的是 Electron（基于 Chromium），GPU 渲染进程在启动早期就初始化了。等 settings.json 加载、GUI 设置读取完，GPU 进程早已跑起来——此时关掉“硬件加速”开关，只影响窗口动画或标题栏透明度，根本动不了渲染管线。

常见错误现象包括：process.argv 里查不到 --disable-gpu、navigator.gpu 返回一个对象（不是 undefined）、任务管理器里仍有 chrome_gpu_process 进程。

• 所有系统下，该参数都必须作为启动命令的一部分传入，不能靠运行时配置
• VSCode 的 window.enableGPUAcceleration 配置项在 2024 年后已移除或彻底失效
• 试图用 "window.webPreferences.enableWebGL": false 等方式绕过，属于无效试探

Windows 快捷方式加参后仍黑屏的典型原因

很多人改了快捷方式目标却没效果，问题往往卡在细节上：

• 没杀干净旧进程：任务管理器里要手动结束所有 Code.exe 和 Code Helper 进程，否则新快捷方式只是拉起已有主进程的子窗口
• 路径含空格但没加英文双引号：比如 C:\Program Files\Microsoft VS Code\Code.exe 必须写成 "C:\Program Files\Microsoft VS Code\Code.exe"，再加空格和 --disable-gpu
• 启动入口不统一：开始菜单、WSL 终端里执行 code .、浏览器点击 vscode:// 链接，都不会继承桌面快捷方式的参数

Linux（Ubuntu）修改 .desktop 文件的实操要点

临时验证可用 code --disable-gpu，但永久生效得改桌面启动文件。注意两个位置都可能生效：

• 全局配置：/usr/share/applications/code.desktop（需 sudo 权限）
• 用户级配置：~/.local/share/applications/code.desktop（推荐优先改这里）

关键不是只改 [Desktop Entry] 下的 Exec= 行——很多发行版还带 [Desktop Action] 段落（比如「New Window」快捷操作），里面也有 Exec=，漏改一处，特定场景就会复现黑屏。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

改法示例（注意空格）：
Exec=/usr/share/code/code --disable-gpu --unity-launch %F
Exec=/usr/share/code/code --disable-gpu --new-window %F

macOS 启动命令与验证方式

终端执行以下命令可立即测试：

open -n -a "Visual Studio Code" --args --disable-gpu

若常用 code 命令，确保它是软链到 app 内部二进制（如 /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code），否则参数会被忽略。

验证是否生效的三步检查：

• Help → Toggle Developer Tools → Console 输入 process.argv，数组中必须含 "--disable-gpu"
• 同一控制台输入 navigator.gpu，返回 undefined 才算成功
• Activity Monitor 里不应再出现独立的 GPU Process

最易被忽略的是 WSLg 场景：即使主 VSCode 已加参，code . 在 WSL 终端里启动仍会新建未带参进程，必须显式写成 code --disable-gpu .。