WSL2 Debian环境下SDL2无法显示窗口的问题求助

问题背景 #

在WSL2 Debian系统中通过apt install安装245MB的libsdl2-dev库后，执行g++ sdl.cpp -lSDL2 -o sdlbasic编译代码曾出现大量错误，重新安装库后编译成功，但运行./sdlbasic时抛出以下错误：

error: XDG_RUNTIME_DIR not set in the environment.
The path /dev/dri/ cannot be opened or is not available
The path /dev/dri/ cannot be opened or is not available
error: XDG_RUNTIME_DIR not set in the environment.
The path /dev/dri/ cannot be opened or is not available
The path /dev/dri/ cannot be opened or is not available

程序延迟10秒后退出，无法显示窗口。测试代码用于在屏幕中央绘制白色像素：

// g++ sdl.cpp -lSDL2 -o sdlbasic

#include <SDL2/SDL.h>
#define swidth 640
#define sheight 480

int main(){
    SDL_Window* window = nullptr;
    SDL_Renderer* renderer = nullptr;

    SDL_Init(SDL_INIT_VIDEO);
    SDL_CreateWindowAndRenderer(swidth, sheight, 0, &window, &renderer); // width and height
    SDL_RenderSetScale(renderer, 4, 4); // x4 render size

    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255); // choose color to draw, rgba
    SDL_RenderClear(renderer);

    SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255); // white
    SDL_RenderDrawPoint(renderer, swidth/2, sheight/2); // draw pixel in center

    SDL_RenderPresent(renderer); // show renderer stuff
    SDL_Delay(10000); // delay until close
    return 0;
}

已尝试的无效方法：

• 重新编译程序
• 参考Stack Exchange教程，但不了解Nautilus的作用

问题原因 #

这两个错误是WSL2运行图形程序的典型问题：

1. XDG_RUNTIME_DIR是X11图形环境的核心环境变量，WSL2默认未自动配置
2. /dev/dri/是GPU硬件加速的设备节点，WSL2需要额外配置才能让Linux子系统访问Windows的GPU资源

解决步骤 #

1. 配置XDG_RUNTIME_DIR环境变量 #

临时配置（仅当前终端生效）：

export XDG_RUNTIME_DIR=/tmp/runtime-$(whoami)
mkdir -p $XDG_RUNTIME_DIR
chmod 0700 $XDG_RUNTIME_DIR

永久配置（所有终端会话生效）：
将上述命令添加到~/.bashrc或~/.zshrc文件末尾，执行source ~/.bashrc使配置立即生效。

2. 配置WSL2图形显示环境 #

WSL2依赖Windows端的图形服务来显示窗口，推荐两种方案：

方案一：使用WSLg（推荐，支持Windows 11/Windows 10 21H2+）

WSLg是微软官方集成的图形服务，无需额外安装第三方软件：

• 打开Windows“控制面板”→“程序和功能”→“启用或关闭Windows功能”，勾选“适用于Linux的Windows子系统”和“虚拟机平台”
• 在WSL2终端执行echo $DISPLAY，若输出为:0或127.0.0.1:0.0，说明WSLg已正常运行
• 若未生效，执行wsl --shutdown重启WSL2子系统

方案二：使用第三方X服务器（如VcXsrv，适用于旧版Windows）

• 在Windows端安装VcXsrv，启动时选择“Multiple windows”，取消勾选“Native opengl”，勾选“Disable access control”
• 在WSL2终端设置DISPLAY变量：

  export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0
  

  同样可将该命令添加到~/.bashrc实现永久生效

3. 验证GPU硬件加速 #

执行以下命令检查/dev/dri设备是否存在：

ls /dev/dri/

若输出包含card0和renderD128，说明GPU硬件加速已配置成功；若未显示，确保Windows已安装最新显卡驱动，然后重启WSL2。

4. 重新运行程序 #

完成上述配置后，重新编译并执行：

g++ sdl.cpp -lSDL2 -o sdlbasic
./sdlbasic

内容的提问来源于stack exchange，提问作者Eja