在 WSL2 中获得完整桌面体验（X11 方案为主）

2.1 打开 systemd#

编辑 /etc/wsl.conf：

1
[boot]
2
systemd=true
3

4
[interop]
5
appendWindowsPath=false

改完在 Windows 侧执行 wsl.exe --shutdown，重新打开终端。

2.2 安装桌面与显示管理器（Fedora 为例）#

1
sudo dnf install -y \
2
  xfce4-session xfwm4 xfce4-panel xfdesktop thunar \
3
  lightdm slick-greeter \
4
  xorg-x11-server-Xwayland

说明：lightdm-gtk-greeter 也能装，但它在 WSL 下更容易踩坑（见 §4.3）。这里我们直接用 slick-greeter。

3.1 修复 /tmp/.X11-unix 并准备 X0#

WSLg 默认把 /tmp/.X11-unix 挂成只读，且里面没有 X0。我们创建一个 oneshot 服务，把它换成可写目录，并把 X0 软链到 WSLg 的共享目录：

1
sudo tee /etc/systemd/system/wslg-fix.service >/dev/null <<'EOF'
2
[Service]
3
Type=oneshot
4
ExecStart=-/usr/bin/umount /tmp/.X11-unix
5
ExecStart=/usr/bin/rm -rf /tmp/.X11-unix
6
ExecStart=/usr/bin/mkdir /tmp/.X11-unix
7
ExecStart=/usr/bin/chmod 1777 /tmp/.X11-unix
8
ExecStart=/usr/bin/ln -s /mnt/wslg/.X11-unix/X0 /tmp/.X11-unix/X0
9
ExecStart=/usr/bin/chmod 0777 /mnt/wslg/runtime-dir
10
ExecStart=/usr/bin/chmod 0666 /mnt/wslg/runtime-dir/wayland-0.lock
11

12
[Install]
13
WantedBy=multi-user.target
14
EOF
15

16
sudo systemctl enable wslg-fix.service

⚠️ 坑：在 WSLg 1.0.79 上，umount /tmp/.X11-unix 有时会因“多层 tmpfs / Device or resource busy”失败，导致 rm 失败、服务起不来，Fedora 44是有一个tmpfs配置文件存在冲突的。可以：

• 重启 WSL（wsl --shutdown）后再让它跑；
• 或先手动 sudo umount -R -l /tmp/.X11-unix，再 sudo systemctl start wslg-fix.service；
• 检查：journalctl -u wslg-fix.service -b 和 ls -l /tmp/.X11-unix/X0。

3.2 把 /usr/bin/Xorg 换成 Xwayland 包装脚本#

先备份真 Xorg，再写包装脚本：

1
sudo mv /usr/bin/Xorg /usr/bin/Xorg.original
2

3
sudo tee /usr/bin/Xorg.Xwayland >/dev/null <<'EOF'
4
#!/bin/bash
5
# 把 Xorg 的参数做一点适配，再转交给 Xwayland
6
for arg do
7
  shift
8
  case $arg in
9
    # Xwayland 不支持 vtxx，转成 ttyxx
10
    vt*) set -- "$@" "${arg//vt/tty}" ;;
11
    # Xwayland 不支持 -keeptty / -novtswitch，丢掉
12
    -keeptty) ;;
13
    -novtswitch) ;;
14
    *) set -- "$@" "$arg" ;;
15
  esac
16
done
17

18
# Xwayland 需要一个指向 WSLg Weston 的 XDG_RUNTIME_DIR
19
if [ ! -d "$HOME/runtime-dir" ]; then
20
  mkdir "$HOME/runtime-dir"
21
  ln -s /mnt/wslg/runtime-dir/wayland-0 \
22
        /mnt/wslg/runtime-dir/wayland-0.lock "$HOME/runtime-dir/"
23
fi
24
export XDG_RUNTIME_DIR="$HOME/runtime-dir"
25

26
# 选一个空闲显示号（注意：Xwayland 实际取最后一个 :N，见下方说明）
27
for displayNumber in $(seq 1 100); do
28
  [ ! -e /tmp/.X11-unix/X$displayNumber ] && break
29
done
30

31
# 窗口模式：去掉 -fullscreen，给固定分辨率
32
command=("/usr/bin/Xwayland" ":${displayNumber}" "-geometry" "1600x900" "$@")
33

34
systemd-cat -t /usr/bin/Xorg echo "Starting Xwayland:" "${command[@]}"
35
exec "${command[@]}"
36
EOF
37

38
sudo chmod 0755 /usr/bin/Xorg.Xwayland
39
sudo ln -sf Xorg.Xwayland /usr/bin/Xorg

📌 实测结论：当命令行里出现多个 :N（包装脚本加的 :1 和 LightDM 传的 :0）时，Xwayland 绑定的是最后一个 :N。所以包装脚本前面的“空闲显示号”其实会被 LightDM 传进来的 :0 覆盖。

真正让整套方案跑通的是 §3.1 的 X0 软链：Xwayland 启动 :0 时会创建 /tmp/.X11-unix/X0，因为它是软链，socket 实际落在了 /mnt/wslg/.X11-unix/X0，从而被 WSLg 暴露给 Windows。

3.3 强制 GTK/Qt 走 X11#

这是整个方案里最容易踩、也最隐蔽的坑。

WSLg 会为每个用户会话创建 /run/user/<uid>/wayland-0 软链。即使你没有设置 WAYLAND_DISPLAY，GTK 的 Wayland 后端在默认情况下也会去找 wayland-0，一旦找到就直接用 Wayland 后端。于是：

• 登录界面（lightdm-gtk-greeter / slick-greeter）是 X11-only 的程序 → 调 gdk_x11_* 时断言失败 → SIGSEGV 闪退；
• XFCE 里的 GTK 程序也会跑到 Wayland 上，绕过 xfwm4，窗口没有边框、不被管理。

文章里常见的做法是改 user-runtime-dir@.service：

1
sudo mkdir -p /etc/systemd/system/user-runtime-dir@.service.d
2
sudo tee /etc/systemd/system/user-runtime-dir@.service.d/override.conf >/dev/null <<'EOF'
3
[Service]
4
ExecStartPost=-/usr/bin/rm -f /run/user/%i/wayland-0 /run/user/%i/wayland-0.lock
5
EOF
6
sudo systemctl daemon-reload

⚠️ 但在 WSLg 1.0.79 上，WSLg 会把 wayland-0 软链重新造回来，这条 rm 挡不住。所以我们改用更稳的方式：直接强制后端。

1
sudo tee /usr/local/bin/slick-greeter-x11 >/dev/null <<'EOF'
2
#!/bin/bash
3
export GDK_BACKEND=x11
4
unset WAYLAND_DISPLAY
5
exec /usr/bin/slick-greeter "$@"
6
EOF
7
sudo chmod 0755 /usr/local/bin/slick-greeter-x11
8

9
sudo tee /usr/share/xgreeters/slick-greeter-x11.desktop >/dev/null <<'EOF'
10
[Desktop Entry]
11
Name=Slick Greeter (X11)
12
Comment=LightDM greeter forced to GDK X11 backend
13
Exec=slick-greeter-x11
14
Type=Application
15
EOF
16

17
sudo mkdir -p /etc/lightdm/lightdm.conf.d
18
sudo tee /etc/lightdm/lightdm.conf.d/50-greeter.conf >/dev/null <<'EOF'
19
[Seat:*]
20
greeter-session=slick-greeter-x11
21
EOF

1
sudo tee /etc/X11/xinit/xinitrc.d/99-force-x11.sh >/dev/null <<'EOF'
2
# 强制 GTK/Qt 走 X11，绕过 WSLg 的 wayland-0
3
export GDK_BACKEND=x11
4
export QT_QPA_PLATFORM=xcb
5

6
# 让 Mesa 走 WSL 的 D3D12 后端（GPU: NVIDIA ...），而不是 llvmpipe
7
export GALLIUM_DRIVER=d3d12
8

9
# WSL 的 GPU 工具在 /usr/lib/wsl/lib
10
export PATH="$PATH:/usr/lib/wsl/lib"
11
EOF
12
sudo chmod 0755 /etc/X11/xinit/xinitrc.d/99-force-x11.sh

1
sudo tee /etc/profile.d/99-wsl-gpu.sh >/dev/null <<'EOF'
2
case ":$PATH:" in
3
  *:/usr/lib/wsl/lib:*) ;;
4
  *) export PATH="$PATH:/usr/lib/wsl/lib" ;;
5
esac
6
export GALLIUM_DRIVER=d3d12
7
EOF
8
sudo chmod 0644 /etc/profile.d/99-wsl-gpu.sh

3.4 让 LightDM 成为默认显示管理器#

1
sudo systemctl disable gdm 2>/dev/null
2
sudo systemctl enable lightdm
3
sudo systemctl set-default multi-user.target   # 或 graphical.target，见下
4
sudo systemctl start lightdm

如果你希望开机自动进图形，用 graphical.target；如果想像文章那样“手动起”，就保持 multi-user.target，需要时：

1
sudo systemctl start graphical.target

4.1 确认 Xwayland 在跑、分辨率正确#

1
pgrep -a Xwayland
2
# 用 greeter/会话的 XAUTHORITY 查 :0
3
sudo xrandr --display :0   # 或在会话里 xrandr
4
# 期望看到 1600x900
5

6
# 包装脚本日志
7
journalctl -b -t /usr/bin/Xorg | tail

4.2 确认 GPU 真的用上了#

1
glxinfo -B | grep -E "renderer|Accelerated"
2
# 期望：D3D12 (NVIDIA GeForce RTX 4060) / Accelerated: yes
3

4
glmark2 -s 800x600 -b desktop
5
nvidia-smi

我们实测的数据（RTX 4060）：

📌 别用 glxgears 判断 GPU：它默认开 vsync（锁 60Hz），而且负载太轻，CPU 都能 800+ FPS。要比性能用 glmark2，并且比较时一定用同一个 -s 分辨率——800×600 和 1080p 的像素量差 4 倍多，帧率会差 3～4 倍。

4.3 坑：greeter 一启动就闪退#

现象：/var/log/lightdm/lightdm.log 里反复出现

1
Greeter closed communication channel
2
Seat seat0: Stopping; failed to start a greeter
3
Display manager stopped ... Exiting with return value 1

seat0-greeter.log 末尾：

1
Gdk-CRITICAL: gdk_x11_window_get_xid: assertion 'GDK_IS_X11_WINDOW (window)' failed

dmesg：

1
lightdm-gtk-gre[xxxx]: segfault at ... in libX11.so.6

根因：不是 lightdm 崩，而是 greeter 崩。而且根因是 GDK 选了 Wayland 后端（见 §3.3）：greeter 是 X11-only 程序，拿到的 window/display 不是 X11 对象，随后把野指针传给 XInternAtom → SIGSEGV。

解决：按 §3.3 用 GDK_BACKEND=x11 包装 greeter。lightdm-gtk-greeter 和 slick-greeter 都会中招，任选其一 + 包装脚本即可。

4.4 坑：登录后窗口没有边框、没有最小化/最大化/关闭#

根因：XFCE 的窗口管理器 xfwm4 没启动。检查：

1
pgrep -a xfwm4        # 没有输出就是没起

~/.xsession-errors 开头会有：

1
Failed to fetch _NET_NUMBER_OF_DESKTOPS; assuming 1
2
Failed to get _NET_WORKAREA; using full screen dimensions

这些 _NET_* 都是窗口管理器设置的——没有它，自然没有标题栏。

原因：~/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-session.xml 里 SessionName=Default，但 Failsafe 的 Client*_Command 被写空，导致 xfce4-session 没有拉起 xfwm4。

解决（重置会话配置 + 兜底自启动）：

1
# 备份并移走有问题的会话配置，改用系统默认 Failsafe（第一个客户端就是 xfwm4）
2
mv ~/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-session.xml \
3
   /tmp/xfce4-session.xml.orig
4

5
# 清空会话缓存
6
rm -rf ~/.cache/sessions/*
7

8
# 兜底：在 autostart 里显式启动 xfwm4
9
mkdir -p ~/.config/autostart
10
cat > ~/.config/autostart/xfwm4.desktop <<'EOF'
11
[Desktop Entry]
12
Type=Application
13
Name=Xfwm4
14
Comment=Xfce Window Manager
15
Exec=xfwm4 --replace
16
Terminal=false
17
NoDisplay=true
18
EOF

注销重登后 pgrep xfwm4 应该有输出，窗口也就有边框和按钮了。

4.5 坑：会话里 nvidia-smi: command not found#

WSL 的 GPU 工具在 /usr/lib/wsl/lib/，但 LightDM 给会话的 PATH 很精简（可能只有 /usr/local/bin:/usr/bin），所以找不到。两条一起做：

1
# 立刻可用
2
sudo ln -sf /usr/lib/wsl/lib/nvidia-smi /usr/local/bin/nvidia-smi
3

4
# 登录 shell 也补上 PATH（见 §3.3 的 /etc/profile.d/99-wsl-gpu.sh）

4.6 坑：整个桌面是全屏，想窗口化#

改包装脚本里的 -geometry 和 -fullscreen：

1
# 原来： Xwayland ... "-geometry" "1920x1080" "-fullscreen" ...
2
# 改成： Xwayland ... "-geometry" "1600x900" ...

然后 sudo systemctl restart lightdm。想改回全屏就把 -fullscreen 加回去。

注意：这是嵌套式 Xwayland，整个桌面是一个 X 窗口。缩放外层 Windows 窗口时，X 根分辨率不一定跟着变；要换分辨率就改 -geometry 重启。

4.7 坑：GDM/GNOME 方案在 Fedora 44 上是死路#

之前参考的网上一篇文章（“在 wsl2 中使用 wslg 实现完整桌面环境”）是用 GDM + GNOME（Ubuntu 24.04） 演示的。它能把 /usr/bin/Xorg 换成 Xwayland，是因为 GDM 当时会用 Xorg 起 greeter。

但在 Fedora 44 / GNOME 50 上：

• gnome-shell --help 里已经没有 --x11，GNOME 50 是 Wayland-only；
• /usr/share/xsessions/ 里不再有 GNOME 的 X11 会话；
• GDM 的 greeter 就是 gnome-shell --mode=gdm，只能跑 Wayland；
• 而 Wayland greeter 需要 DRM/KMS，WSL 的 /dev/dri 是假的 vgem（/devices/faux/vgem/...）→ 直接失败：

1
Running GNOME Shell ... as a Wayland display server
2
MESA-EGL: warning: egl: failed to create dri2 screen
3
MESA-EGL: warning: NEEDS EXTENSION: falling back to kms_swrast
4
org.gnome.Shell@gdm.service: Failed with result 'protocol'
5
GdmDisplay: Session never registered

WaylandEnable=false 也救不了（因为 greeter 本身没有 X11 模式了）。所以 Fedora 44 上请走 LightDM + X11 桌面（XFCE 等）。

6.1 基本玩法#

niri 以 winit 嵌套后端 运行在 WSLg 的 Weston 里：

1
# 你的 shell 里需要有指向 WSLg Weston 的 Wayland 环境
2
# （WSLg 登录会话通常已经设好 WAYLAND_DISPLAY=wayland-0 / XDG_RUNTIME_DIR=/run/user/1000）
3
niri --session

niri 自己会监听 wayland-1（给它启动的客户端）和 X11 socket（通过 xwayland-satellite）。它的外层窗口由 winit 创建，因为 WSLg 不提供服务端装饰（没有 zxdg_decoration_manager_v1），所以窗口边框是 CSD（客户端自绘）——这也是为什么 niri 的窗口看起来有边框，而 sway 没有。

6.2 坑：点“最大化”时 niri 闪退#

现象：niri 外层窗口点标题栏最大化，niri 偶尔/经常 SIGSEGV：

1
niri[xxxx]: segfault at 40 ... in libEGL_mesa.so.0.0.0[...]
2
niri.service: Main process exited, code=killed, status=11/SEGV

根因：WSLg 没有 dmabuf，Mesa 只能走 Wayland 软件呈现路径。resize 的瞬间，dri2_surf->back 还没就绪，而 Mesa 里只有一句被 release 构建编译掉的 assert：

1
static void *
2
dri2_wl_swrast_get_backbuffer_data(struct dri2_egl_surface *dri2_surf)
3
{
4
   assert(dri2_surf->back);        // release 下无效
5
   return dri2_surf->back->data;   // back == NULL → [NULL+0x40] → SIGSEGV
6
}

（libEGL_mesa 里 dri2_wl_swrast_put_image2 调它，对应 platform_wayland.c 的 dst += y * dst_stride;。）

我们查了 Mesa 26.2.6 和 main，上游都还没修。于是我给它打了个补丁并重编 libEGL_mesa：

1
/* 1) 判空而不是 assert */
2
static void *
3
dri2_wl_swrast_get_backbuffer_data(struct dri2_egl_surface *dri2_surf)
4
{
5
   if (!dri2_surf->back)
6
      return NULL;
7
   return dri2_surf->back->data;
8
}
9

10
/* 2) put_image2 里 back 没就绪就跳过这一帧 */
11
dst = dri2_wl_swrast_get_backbuffer_data(dri2_surf);
12
if (!dst)
13
   return;

效果：resize 时极端情况下丢一帧而不是崩溃（可能表现为轻微闪烁），最大化就稳定了。

6.3 编译与替换（简述）#

1
# 1. 装构建依赖（Fedora：用 mesa 的 spec 最省事）
2
sudo dnf builddep -y ./mesa.spec
3

4
# 2. 打补丁后，用 meson 只编 libEGL_mesa
5
meson setup build -Dprefix=/usr -Dbuildtype=release \
6
  -Dplatforms=x11,wayland -Dgallium-drivers=softpipe \
7
  -Dvulkan-drivers= -Dvulkan-layers= \
8
  -Dgallium-rusticl=false -Dmicrosoft-clc=disabled \
9
  -Dglx=dri -Degl=enabled -Dgles1=enabled -Dgles2=enabled -Dopengl=true \
10
  -Dgbm=enabled -Dglvnd=enabled -Dllvm=disabled \
11
  -Dbuild-tests=false -Dtools= -Dvideo-codecs=
12
ninja -C build src/egl/libEGL_mesa.so.0.0.0
13

14
# 3. 去掉 build 目录 RPATH（让它用系统的 libgallium），备份后替换
15
patchelf --remove-rpath build/src/egl/libEGL_mesa.so.0.0.0
16
sudo cp -a /lib64/libEGL_mesa.so.0.0.0 /lib64/libEGL_mesa.so.0.0.0.orig
17
sudo cp build/src/egl/libEGL_mesa.so.0.0.0 /lib64/libEGL_mesa.so.0.0.0

验证：

1
objdump -d /lib64/libEGL_mesa.so.0.0.0 | grep -A3 '450'   # 应能看到 test %rax,%rax; je
2
glxinfo -B | grep -E "renderer|Accelerated"                # D3D12 / yes

⚠️ 以后 dnf update mesa-* 会覆盖这个补丁，需要重新打。回滚： sudo cp -a /lib64/libEGL_mesa.so.0.0.0.orig /lib64/libEGL_mesa.so.0.0.0

6.4 niri 的日志里那些 warning 要不要管？#

1
MESA-EGL: failed to get driver name for fd -1
2
MESA-LOADER: failed to retrieve device information
3
failed building default dmabuf feedback ... error getting EGL device render node
4
EGL_EXT_device_drm ... at least one is required

不用管，也不影响其他软件。它们只是说明「WSL 没有真 DRM、没有 EGL_EXT_device_drm、dmabuf 零拷贝不可用，自动回退到 shm」。GPU 渲染（d3d12）、CUDA 都正常。真的受影响的是多 GPU 选择、DRM leasing、VR、部分录屏工具这些边缘功能。

另外两条：

1
error inhibiting power key: AccessDenied
2
XDG_SESSION_ID is unset or invalid; logind LockedHint won't be set

是 logind 集成的小问题（电源键抑制、锁屏状态），与图形无关。