WSL2中Gazebo 11.14.0 GUI显示模糊无法正常运行求助

核心原因 #

• WSL2与Windows主机的X服务器高DPI适配不匹配
• Gazebo的QT界面渲染未适配WSL2的显示环境
• 系统显卡驱动或WSL内核版本过低导致渲染异常

具体解决方案 #

1. 优化X服务器显示设置 #

如果使用VcXsrv作为X服务器，启动时务必勾选Disable access control，并在额外设置中开启High DPI scaling的自动适配；若用Windows Terminal，在终端设置里开启UTF-8支持，同时调整终端缩放级别与主机屏幕一致。

2. 配置Gazebo专属环境变量 #

临时生效可在终端执行：

export QT_AUTO_SCREEN_SCALE_FACTOR=1
export QT_SCALE_FACTOR=1
export GAZEBO_GUI_DPI=96

要永久生效，将上述命令追加到~/.bashrc文件末尾，再执行source ~/.bashrc使配置生效。

3. 更新系统与驱动 #

• Windows端：前往显卡厂商官网（NVIDIA/AMD/Intel）下载并安装最新驱动
• WSL2内执行：

sudo apt update && sudo apt upgrade -y
sudo apt install linux-generic-hwe-20.04

完成后重启WSL2。

4. 切换渲染后端 #

尝试切换到OpenGL ES渲染模式，执行：

export GAZEBO_RENDERING_API=gles
rosrun gazebo_ros gazebo

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