怎样解决在ubuntu 22.04上QT: DataVisualization控件显示黑屏的问题

浪小满2025-06-18 16:17

最近ubuntu 22.04中搭建QT开发环境中发现如下问题，QT提供的Example代码工程中其他控件和界面显示正常，但是DataVisualization控件显示黑屏，排查了很久才得以解决，这里记录一下解决方案。【该方案也能解决："Warning: Ignoring XDG_SESSION_TYPE=wayland on Gnome. Use QT_QPA_PLATFORM=wayland to run on Wayland anyway." 的问题】

安装QT界面和控件显示依赖的基础库。

bash 复制代码

sudo apt update
sudo apt install build-essential 
sudo apt install libwayland-dev libwayland-egl-backend-dev -y
sudo apt install mesa-utils mesa-common-dev libgl1-mesa-dev libglu1-mesa-dev libegl1-mesa-dev libfuse2 libsm6 libxcb-cursor0 -y

修改环境配置，因为Ubuntu 22.04默认使用Wayland作为显示协议，而Qt:DataVisualization可能与Wayland存在兼容性问题，可以通过以下步骤禁用Wayland，改用X11：

bash 复制代码

sudo nano /etc/gdm3/custom.conf

找到**#WaylandEnable=false** 这一行，去掉前面的注释符号**#**。保存文件并重启系统。

然后在/etc/profile中增加环境变量：

bash 复制代码

sudo nano /etc/profile

文件打开后增加如下信息：

bash 复制代码

## QT GUI
export QT_QPA_PLATFORM=xcb
export QT_OPENGL=desktop
export QT_XCB_FORCE_SOFTWARE_OPENGL=1

保存文件后退出，执行环境信息，并重启系统生效：

bash 复制代码

source /etc/profile
reboot

后面打开QtCreator，编译程序，发现界面能够显示成功。