WSLg需启用“适用于Linux的Windows子系统”和“虚拟机平台”,更新内核至5.10+,安装Ubuntu等GUI发行版,或通过Microsoft Store安装WSL Preview,也可用VcXsrv配置X11转发作为备用方案。

一、启用WSL及虚拟机平台核心功能
若系统未激活底层子系统与虚拟化支持,WSLg将无法加载图形栈。必须显式开启两项Windows功能,否则后续所有GUI操作均会失败。
1、在Windows搜索栏输入“启用或关闭Windows功能”,打开该设置界面。
2、勾选“适用于Linux的Windows子系统”和“虚拟机平台”两项。
3、点击“确定”,等待系统应用更改并提示重启。
4、必须立即重启计算机,否则新功能不会被内核加载,WSLg初始化将报错。
二、安装并更新WSL内核至WSLg就绪版本
WSLg依赖于5.10及以上内核版本,并需内置Wayland合成器与vGPU驱动接口。仅启用功能不足以启用GUI,必须安装带GUI支持的最新内核包。
1、以管理员身份打开Windows Terminal或PowerShell。
2、执行命令:wsl --update,自动下载并安装含WSLg支持的内核。
3、运行wsl --shutdown强制终止所有WSL实例,确保下次启动时加载新内核。
4、启动任意已安装发行版,在终端中执行echo $DISPLAY,输出应为:0,表明显示环境已就绪。
三、通过一键命令全新部署WSLg完整环境
该方法绕过分步配置,直接拉取预集成WSLg图形栈的Ubuntu发行版,适用于无历史WSL安装的用户,可避免版本不兼容问题。
1、以管理员身份打开Windows Terminal。
2、执行安装命令:wsl --install -d Ubuntu。
3、系统自动启用功能、下载内核、安装发行版并提示重启。
4、重启后首次启动Ubuntu,按提示设置用户名和密码。
5、登录后运行:sudo apt update && sudo apt install x11-apps -y && xeyes,若弹出可随鼠标移动的眼睛窗口,即确认WSLg已激活。
四、通过Microsoft Store安装WSL Preview套件
此路径完全基于图形界面操作,不依赖PowerShell权限,适合企业策略禁用命令行或IT管理受限环境,所安装组件经微软签名验证且默认启用GUI支持。
1、打开Microsoft Store应用,在搜索栏输入Windows Subsystem for Linux Preview。
2、点击“获取”按钮下载并安装WSL Preview应用。
3、安装完成后,在开始菜单中启动该应用,按向导安装Ubuntu、Debian或Kali Linux等任一支持GUI的发行版。
4、安装完毕后,从开始菜单中打开对应发行版文件夹,选择“Launch”启动终端。
5、在终端中执行:sudo apt install gedit -y,随后输入gedit即可启动图形文本编辑器。
五、手动配置X11转发作为备用图形方案
当WSLg因驱动缺失、系统版本低于22000或vGPU未启用而失效时,可通过第三方X服务器实现基础GUI渲染,该方案不依赖WSLg,兼容性更广但无硬件加速。
1、在Windows主机上下载并安装VcXsrv(推荐)或Xming。
2、启动VcXsrv,配置时选择“Multiple windows”,勾选“Disable access control”,取消勾选“Native opengl”以防冲突。
3、在WSL终端中执行:export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2; exit;}'):0,动态获取Windows主机IP。
4、为使该变量持久生效,将上述export命令追加至~/.bashrc文件末尾。
5、执行sudo apt install x11-apps -y && xclock,若弹出模拟时钟窗口,即表示X11转发通道已通。










