必须安装并启用WSLg才能运行Linux图形界面软件,它随WSL核心更新部署,要求Windows 11≥22000或Win10≥19044、启用虚拟机平台、WSL 2模式及重启生效。

要在Windows系统中让WSL子系统运行Linux图形界面软件(如gedit、GIMP、VS Code GUI版),必须安装并启用WSLg——这是微软为WSL 2设计的原生GUI支持组件,不是独立安装包,而是随WSL核心更新一并部署的图形协议栈。
确认系统基础条件
打开PowerShell(管理员),执行:wsl --status。若返回“WSL version: 2.x.x”且无报错,说明WSL 2已就绪;若提示“command not found”,需先启用Windows功能。这一步跳过会导致后续所有GUI命令静默失败。
检查Windows版本:按Win+R输入winver回车,确认版本号≥22000(即Windows 11正式版)或Windows 10 ≥ Build 19044。低于此版本无法加载WSLg图形驱动,强行操作无效。
【必须开启虚拟机平台】在管理员PowerShell中运行:dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart,执行后立即重启电脑——不重启则WSLg的vGPU模块无法初始化。
全新安装WSLg(推荐首次用户)
适用于从未装过任何WSL环境的用户,该命令会自动下载最新WSL内核、启用WSLg、安装Ubuntu发行版并配置DISPLAY变量。
以管理员身份打开Windows Terminal,输入:wsl --install -d Ubuntu。
等待终端显示“Installation complete”后,必须立即重启电脑——重启过程中系统会注入WSLg所需的RDP代理服务和Wayland合成器组件,跳过此步将导致xeyes等测试程序报“Cannot open display”错误。
重启后首次启动Ubuntu,按提示设置用户名与密码;登录后执行:sudo apt update && sudo apt install x11-apps -y && xeyes。若弹出可随鼠标移动的眼睛窗口,说明WSLg已激活。
升级现有WSL至WSLg支持状态
适用于已安装WSL但只能跑命令行程序的老用户,重点是更新内核+强制切换为WSL 2+重载图形协议栈。
第一步:在管理员PowerShell中运行 wsl --update,确保WSL内核版本≥5.15.133.1(2026年主流稳定版)。
师生共创生态系统对接指南。当用户需要对接大学政策、平台资源、投资机构、产业伙伴等外部资源支持时使用。触发词:师生共创生态、大学支持、平台赋能、投资对接、产业合作、政策支持、清华x-lab、孵化器、创业资源
第二步:查看当前发行版名称,执行 wsl -l -v,记下NAME列内容(如Ubuntu-24.04)。
第三步:将其升级为WSL 2模式:wsl --set-version Ubuntu-24.04 2。注意:WSLg仅支持WSL 2,WSL 1无法运行任何GUI应用,即使DISPLAY变量存在也必然失败。
第四步:关闭全部WSL实例:wsl --shutdown。这一步不可省略——旧进程会锁住DISPLAY socket,新会话无法接管图形通道。
第五步:重新打开该发行版终端,输入 echo $DISPLAY,输出应为 localhost:0;再运行 xclock(需先sudo apt install x11-apps),窗口弹出即成功。
通过Microsoft Store安装WSL Preview(免命令行方案)
适合企业环境禁用PowerShell、或偏好纯图形化操作的用户,该方式直接获取预集成WSLg的最新预览套件。
方法一:打开Microsoft Store → 搜索“Windows Subsystem for Linux Preview” → 点击“获取”安装。
方法二:安装完成后,从开始菜单启动“WSL Preview”,界面会引导你选择发行版(Ubuntu/Debian/Kali等)并一键安装,全程无需敲命令。
安装完毕后,在开始菜单中找到对应发行版图标(如“Ubuntu 24.04”)→ 右键 → “更多” → “以管理员身份运行”,然后执行 sudo apt install gedit -y && gedit。若文本编辑器窗口正常出现,说明WSLg已就位。
注意:Store版WSL自带WSLg,无需额外配置,但首次启动GUI应用时可能有1~3秒延迟——这是Wayland合成器初始化所需时间,属正常现象。










