Wayland 兼容性问题
Wayland 概述
Ubuntu 26.04 默认使用 Wayland 显示协议。Wayland 比 X11 更安全、更高效，但部分旧应用程序可能存在兼容性问题。
# 确认当前会话类型
echo $XDG_SESSION_TYPE
# wayland 或 x11常见兼容性问题
应用窗口模糊或缩放异常
某些使用 X11 的应用在 XWayland 下可能模糊（特别是高 DPI 屏幕）。
# 强制某个应用使用 Wayland 原生（如果支持）
GDK_BACKEND=wayland 应用名
# 强制使用 X11（通过 XWayland）
GDK_BACKEND=x11 应用名
# Qt 应用
QT_QPA_PLATFORM=wayland 应用名
QT_QPA_PLATFORM=xcb 应用名 # 强制 X11屏幕共享/录制不可用
Wayland 限制应用直接访问屏幕内容。需要通过 xdg-desktop-portal 实现屏幕共享。
# 确认 portal 服务运行
systemctl --user status xdg-desktop-portal
systemctl --user status xdg-desktop-portal-gnome
# 重启 portal 服务
systemctl --user restart xdg-desktop-portal在浏览器中进行屏幕共享时，确保使用支持 PipeWire 的浏览器（Firefox、Chrome 均已支持）。
远程桌面工具不工作
部分远程桌面工具（如 TeamViewer、AnyDesk）在 Wayland 下可能有问题：
# 使用 GNOME 内置远程桌面
# 设置 > 系统 > 远程桌面
# 或安装支持 Wayland 的 VNC
sudo apt install gnome-remote-desktop全局快捷键失效
Wayland 不允许应用监听全局键盘事件（安全限制）。
解决方案：
- 使用 GNOME 设置中的快捷键配置
- 部分应用（如 Flameshot）需要通过 D-Bus/portal 接口注册快捷键
剪贴板问题
Wayland 下不同应用间的剪贴板可能不互通：
# 安装 wl-clipboard 工具
sudo apt install wl-clipboard
# 复制
echo "内容" | wl-copy
# 粘贴
wl-paste输入法问题
# 确认输入法框架
# Fcitx5（推荐）
sudo apt install fcitx5 fcitx5-chinese-addons
# 设置环境变量
# 在 /etc/environment 中添加：
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitxElectron 应用
许多 Electron 应用（VS Code、Slack 等）需要启用 Wayland 支持：
# 添加启动参数
code --enable-features=UseOzonePlatform --ozone-platform=wayland
# 或修改 .desktop 文件中的 Exec 行
# 添加 --ozone-platform=wayland需要 X.org 会话时怎么办
从 Ubuntu 26.04 起，默认的 Ubuntu Desktop（GNOME）会话是 Wayland-only，登录界面不再提供 “GNOME on Xorg” 选项，/etc/gdm3/custom.conf 中的 WaylandEnable=false 也不再生效。如果某个应用确实必须运行在原生 X.org 之上，可以选择：
方案一：安装提供 X.org 会话的其他桌面
KDE Plasma、Xfce、MATE、i3 等桌面仍然提供 X.org 会话。安装后在登录界面右下角的齿轮菜单中选择对应的 X.org 会话即可：
# 任选其一
sudo apt install kubuntu-desktop # KDE Plasma（含 Plasma on X11）
sudo apt install xubuntu-desktop # Xfce（X.org 会话）
sudo apt install ubuntu-mate-desktop方案二：在该桌面会话下使用 X11
登录到上述桌面的 X.org 会话后，xrandr、xdotool、xclip 等 X11 工具即可正常工作；GNOME 会话下应改用 Wayland 原生工具（wl-clipboard、ydotool、GNOME 设置等）。
大多数 X11 应用其实无需切换会话，在 Wayland 下会自动通过 XWayland 运行。只有少数依赖 X.org 服务器特性（如全局热键、屏幕录制旧接口）的场景才需要 X.org 会话。
XWayland
XWayland 是 Wayland 环境下的 X11 兼容层，大部分 X11 应用会自动通过 XWayland 运行。
# 检查某个窗口是否通过 XWayland 运行
# 安装 xprop
sudo apt install x11-utils
xprop | grep -i xwayland
# 如果能选中窗口，说明窗口运行在 XWayland 上在 GNOME 中，按 Alt+F2 输入 lg（Looking Glass），在 Windows 标签中可查看每个窗口是否为 XWayland。
NVIDIA 与 Wayland
NVIDIA 显卡用户需要确保：
# 驱动版本 535 或更高
nvidia-smi | grep "Driver Version"
# 确认 GBM 后端已启用
ls /usr/lib/x86_64-linux-gnu/libnvidia-egl-gbm.so*
# 在 /etc/environment 中添加（如果需要）
# GBM_BACKEND=nvidia-drm
# __GLX_VENDOR_LIBRARY_NAME=nvidia应用兼容性速查
| 应用 | Wayland 支持 | 备注 |
|---|---|---|
| Firefox | 原生支持 | 默认 Wayland |
| Chrome/Chromium | 原生支持 | 需启动参数 |
| VS Code | 支持 | 需 ozone 参数 |
| LibreOffice | 原生支持 | — |
| GIMP | XWayland | 工作正常 |
| VLC | 原生支持 | — |
| OBS Studio | 原生支持 | 使用 PipeWire 采集 |
| Steam | XWayland | 基本正常 |
| Wine/Proton | XWayland | 基本正常 |