先判断系统前提
在 WSL2 里给 Cursor 配 GPU 加速,先别急着改配置。很多情况下你看到的是界面卡顿、拖影或者黑屏,但根因往往不在 Cursor 本身。先确认系统是否支持 WSLg,因为 Cursor 的图形界面要靠 WSLg 转发到 Windows 侧渲染。如果你只在 WSL2 里写后端代码,平时不打开图形界面,这一步可以跳过;如果你是从 Windows 桌面切到 WSL2 感觉明显变卡,再往下走。
要判断 WSL2 是否具备 GPU 加速条件,首先确认系统版本:Windows 10 21H2 或 Windows 11 才完整支持 WSLg。接着在 PowerShell 中执行 `wsl --status`,确认默认版本为 2;如果版本过低,运行 `wsl --update` 升级。对于 NVIDIA 用户,在 Windows 侧安装最新驱动后,进入 WSL 终端运行 `nvidia-smi`。若能看到 GPU 型号和驱动版本,说明 WSL 已直通 GPU;若提示命令不存在或无输出,则需重启 WSL(`wsl --shutdown` 后重新进入),或检查 Windows 驱动是否真的安装了 WSL 支持组件。
配置 Cursor 的 GPU 加速,核心是让 WSLg 能正常工作。在 `C:\Users\\.wslconfig` 文件中,确认有 `[wsl2]` 段且包含 `guiApplications=true`(默认值,显式写出更稳妥)。随后重启 WSL,并在 WSL 内执行 `echo $DISPLAY`,若输出 `:0` 说明 WSLg 接管了图形界面。此时启动 Cursor,默认就会使用 GPU 渲染。若想强制 Electron 启用硬件加速,可在启动命令中加入 `--enable-gpu-rasterization --enable-zero-copy`,但大多数情况下默认配置已足够。
要判断 WSL2 是否具备 GPU 加速条件,首先确认系统版本:Windows 10 21H2 或 Windows 11 才完整支持 WSLg。接着在 PowerShell 中执行 wsl --status,确认默认版本为 2;如果版本过低,运行 wsl --update 升级。对于 NVIDIA 用户,在 Windows 侧安装最新驱动后,进入 WSL 终端运行 nvidia-smi。若能看到 GPU 型号和驱动版本,说明 WSL 已直通 GPU;若提示命令不存在或无输出,则需重启 WSL(wsl --shutdown 后重新进入),或检查 Windows 驱动是否真的安装了 WSL 支持组件。
这一段判断适用于 NVIDIA 显卡为主的常用环境,AMD 和 Intel 核显的判定逻辑类似,但输出内容会有差异。nvidia-smi 在 WSL 终端里显示的是 vGPU 驱动版本,跟 Windows 侧一致,这只能说明驱动映射完成,不代表 WSL 独占或直通了整块显卡。走到这一步可以继续往下推:WSL2 能识别 GPU,接下来问题就集中在 WSLg 和 Electron 应用之间。
让 WSLg 接管图形界面
配置 Cursor 的 GPU 加速,核心是让 WSLg 能正常工作。在 C:\Users\.wslconfig 文件中,确认有 [wsl2] 段且包含 guiApplications=true(默认值,显式写出更稳妥)。随后重启 WSL,并在 WSL 内执行 echo $DISPLAY,若输出 :0 说明 WSLg 接管了图形界面。此时启动 Cursor,默认就会使用 GPU 渲染。若想强制 Electron 启用硬件加速,可在启动命令中加入 --enable-gpu-rasterization --enable-zero-copy,但大多数情况下默认配置已足够。
注意 .wslconfig 是全局配置,改动会影响所有 WSL 发行版。如果机器上装了多个发行版,并且某些发行版依赖自定义启动参数,要先判断这个改动会不会破坏其他环境。执行 echo $DISPLAY 后,如果输出不是 :0,而是 127.0.0.1:0 或 :1,说明有第三方 X Server 在改写这个变量,先处理变量再启动 Cursor。对应的配置段落可以写成:
[wsl2]
guiApplications=true
这里不要额外调高 memory 或 processors,这两个值跟渲染加速没有直接关系,改大了反而会压缩 Windows 可用的资源。若决定加上 --enable-gpu-rasterization 和 --enable-zero-copy,要知道它们只影响 Chromium 内部的合成方式,不改变 WSLg 的转发路径。驱动有问题时,这两个参数不会带来本质变化;界面已经不卡时,加上它们通常也很难感知到差别。建议先把默认配置跑起来,确认渲染器类型后再决定要不要追加。
验证 GPU 加速是否真的生效
在 WSL2 中验证 GPU 加速是否真的生效,可运行 glxinfo | grep "OpenGL renderer"。如果输出显示你的独立显卡型号(如 NVIDIA GeForce RTX 3060),而非 llvmpipe 或 softpipe 这样的软件渲染器,说明 OpenGL 硬件加速已启用。若没有 glxinfo,先安装 mesa-utils:sudo apt install mesa-utils。对 Cursor 本身,可按 Ctrl+Shift+P 输入 GPU,查看相关调试信息;或使用 cursor --verbose 启动,观察日志中是否有 Hardware acceleration enabled 字样。
这里有两层验证需要分清。glxinfo 反映的是 WSLg 向上层提供的 OpenGL 能力,对应系统级显卡映射;Cursor 是 Electron 应用,实际渲染由 Chromium 的 GPU 进程负责,两者有关系,但不完全等价。在 Cursor 命令面板输入 GPU 可以看到 GPU 进程状态,如果输出里出现 SwiftShader 或软件渲染相关字眼,说明 Chromium 层面没有拿到显存。日志里出现 Hardware acceleration enabled 只代表进程启用了硬件加速开关,真正是否落到 GPU 上,还要看绘制信息里有没有出现具体显卡名称。操作上可以先在 WSL 里跑一遍 glxinfo,再对照 Cursor 内部的 GPU 状态,能更快定位是哪一层失效。
失败时先回滚配置再看日志
配置失败时有一个容易被忽略的顺序:先还原 .wslconfig,重启 WSL,再重新打开 Cursor。不要一边修改配置一边观察,因为 WSL 进程可能缓存了旧参数。WSL2 不对应用层暴露 PCIe 直通,显卡硬件始终归 Windows 管理,WSL 里的 Cursor 只是通过 WSLg 转发调用,这决定了性能和兼容性受 Windows 驱动版本影响很大。如果更新驱动后,WSL 里 nvidia-smi 提示驱动版本不兼容,通常是因为 WSL 内装了某个 CUDA toolkit,版本跟驱动对不上。正确顺序是先更新 Windows 驱动,再在 WSL 内对齐 CUDA 版本;顺序反了,排查时间会明显变长。
容易误判的两个场景
一个误判是第三方 X Server 和 WSLg 混用。以前为了在 WSL 里跑图形程序,不少人装过 VcXsrv,手动设置过 DISPLAY=127.0.0.1:0。如果这个值写进了 .bashrc,每次进入 WSL 都会覆盖 WSLg 的 :0,WSLg 的默认值就失去了作用。打开 Cursor 时界面可能能正常显示,但走的不是 WSLg 的 GPU 路径,整体仍然停留在软件渲染水平。检查 echo $DISPLAY,看到 localhost 开头的地址,就要先清理旧的 X Server 配置。
另一个误判是软件渲染变量残留。如果有人在 .bashrc 或 .profile 里写过 LIBGL_ALWAYS_SOFTWARE=1,即使 WSLg 正常、驱动正常,OpenGL 依然会强制走软件渲染,并且不会产生报错。这种问题容易被当成“GPU 加速配置没有生效”,实际上配置链路没有问题,清理掉变量后重启 Cursor 即可。Cursor 在 WSL2 下的 GPU 加速,关键不在于堆参数,而是确认每一步落到哪个渲染路径。按系统版本、wsl --status、nvidia-smi、$DISPLAY、glxinfo 的顺序走一遍,基本能定位到是哪一层没有工作。如果这些都没问题但界面依然卡,回到 Windows 侧检查驱动版本,WSLg 对驱动版本的敏感度比纯 Windows 程序高不少。