Ubuntu 22.04 切换为 X11 会话以解决 QT 桌面程序兼容性问题

1. 问题背景

在 Ubuntu 22.04 及更高版本中，默认的显示服务器已从传统的 X11 切换为 Wayland。虽然 Wayland 在安全性、性能和现代图形支持方面有诸多优势，但它与部分较旧的 QT 桌面应用程序存在兼容性问题。这些问题可能表现为：

窗口渲染异常（黑屏、花屏、闪烁）
输入法无法正常工作
屏幕共享或远程桌面功能失效
特定 GPU 加速功能不可用
应用程序崩溃或无法启动

如果你遇到上述问题，特别是运行基于 QT 框架开发的桌面程序时，切换回 X11 会话通常是有效的解决方案。

2. 检查当前会话类型

在修改之前，首先需要确认你当前正在使用的会话类型。打开终端，执行以下命令：

bash 复制代码

echo $XDG_SESSION_TYPE

命令输出结果可能是：

wayland：表示当前使用 Wayland 会话
x11：表示当前使用 X11 会话

如果输出为 wayland，说明你确实在使用 Wayland，并且切换为 X11 可能有助于解决 QT 程序兼容性问题。

3. 切换为 X11 会话的方法

3.1 修改 GDM3 配置文件

Ubuntu 22.04 默认使用 GDM3（GNOME Display Manager）作为显示管理器。要永久切换到 X11 会话，需要修改其配置文件。

打开终端 ，使用 sudo 权限编辑配置文件：

bash 复制代码

sudo gedit /etc/gdm3/custom.conf

注意：如果你没有安装 gedit，可以使用其他文本编辑器，如 nano 或 vim：
bash 复制代码
sudo nano /etc/gdm3/custom.conf
或
bash 复制代码
sudo vim /etc/gdm3/custom.conf

找到 [daemon] 部分，如果不存在则添加。在该部分下添加或修改以下行：

ini 复制代码

[daemon]
WaylandEnable=false

修改后的文件内容大致如下：

ini 复制代码

# GDM configuration storage
#
# See /usr/share/gdm/gdm.schemas for a list of available options.

[daemon]
# Uncomment the line below to force the login screen to use Xorg
WaylandEnable=false

# Automatic login configuration
# AutomaticLoginEnable = true
# AutomaticLogin = user1

[security]

[xdmcp]

[chooser]

[debug]
# Uncomment the line below to turn on debugging
# More verbose logs
# Additionally lets the X server dump core if it crashes
#Enable=true

保存并关闭文件。

3.2 重启显示管理器使更改生效

修改配置文件后，需要重启 GDM3 服务才能使更改生效：

bash 复制代码

sudo systemctl restart gdm3

执行此命令后，系统会立即注销当前会话并返回到登录界面。请确保在执行前保存所有未保存的工作。

4. 登录时选择 X11 会话

重启 GDM3 后，在登录界面选择你的用户账户时，请注意屏幕右下角的齿轮图标（⚙️）：

点击你的用户名
点击右下角的齿轮图标（⚙️）
从弹出的菜单中选择 "Ubuntu on Xorg" 或 "Ubuntu (Wayland)"（此时应选择前者）
输入密码登录

登录后，再次执行 echo $XDG_SESSION_TYPE 命令，确认输出已变为 x11。

5. 验证 QT 程序兼容性

切换成功后，重新启动之前有兼容性问题的 QT 桌面程序，检查问题是否已解决。常见的 QT 程序包括：

WPS Office
某些版本的 Qt Creator
基于 Electron 的某些应用（部分版本）
一些游戏和多媒体应用程序
虚拟机软件（如 VirtualBox 的某些功能）

6. 注意事项与备选方案

6.1 注意事项

性能差异：X11 在某些方面（如远程桌面、屏幕录制）可能表现更好，但 Wayland 在现代硬件上通常有更好的性能和安全性。
功能差异：某些 Wayland 独占功能（如手势支持、更好的 HiDPI 缩放）在 X11 上可能不可用。
多显示器：X11 对多显示器配置的处理方式与 Wayland 不同，切换后可能需要重新调整显示器设置。
安全沙箱：Wayland 提供更好的应用程序隔离，切换回 X11 会降低这方面的安全性。

6.2 临时切换（无需重启）

如果你只想临时尝试 X11 会话，可以在登录界面直接选择：

注销当前会话
在登录界面点击用户名
点击右下角齿轮图标（⚙️）
选择 "Ubuntu on Xorg"
登录

这种方法不会永久修改配置，下次重启后仍会默认使用 Wayland。

6.3 其他显示管理器

如果你使用的是其他显示管理器（如 LightDM、SDDM），配置方法会有所不同：

LightDM（Ubuntu 衍生版常用）：

bash 复制代码

sudo nano /etc/lightdm/lightdm.conf

添加或修改：

ini 复制代码

[Seat:*]
user-session=ubuntu

SDDM （KDE Plasma 常用）：

配置文件通常位于 /etc/sddm.conf，需要设置 DisplayServer 为 x11。

7. 恢复 Wayland 会话

如果你发现 X11 不能满足需求，或问题已通过其他方式解决，可以轻松恢复 Wayland：

编辑配置文件：

bash 复制代码

sudo gedit /etc/gdm3/custom.conf

将 WaylandEnable=false 改为 #WaylandEnable=false（注释掉）或直接删除该行
重启 GDM3：

bash 复制代码

sudo systemctl restart gdm3

登录时选择 "Ubuntu (Wayland)"

8. 总结

切换显示服务器会话是解决 Ubuntu 22.04+ 中 QT 桌面程序兼容性问题的有效方法。本文介绍了从 Wayland 永久切换回 X11 的完整步骤：

检查当前会话 ：echo $XDG_SESSION_TYPE
修改配置 ：sudo gedit /etc/gdm3/custom.conf，添加 WaylandEnable=false
重启服务 ：sudo systemctl restart gdm3
登录选择：在登录界面选择 "Ubuntu on Xorg"

大多数 QT 程序兼容性问题在切换后会得到解决。如果问题依然存在，可能需要检查应用程序的特定配置、驱动程序更新或考虑其他解决方案。

提示：Ubuntu 社区和开发者正在积极改进 Wayland 的兼容性，未来版本中这些问题可能会逐渐减少。建议定期更新系统，并在新版本发布后尝试切换回 Wayland 以享受其现代特性。