修复 XWayland 下的 Fcitx5 输入法

446 字
2 分钟
修复 XWayland 下的 Fcitx5 输入法

太长不看#

QQ#

linuxqq --ozone-platform=wayland --enable-wayland-ime

Obsidian#

obsidian --enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime

背景#

截至 2026 年 9 月,KDE、GNOME 等一众 DE 都切换到了 Wayland。而许多软件都没有适配 Wayland,因此这些软件需要借助 XWayland 运行。

但是 XWayland 下,Fcitx5 会无法使用。


解决方案#

Note

使用 xorg-xeyes 包提供的 xeyes 来判断当前启用的是 X11 / XWayland 还是原生 Wayland。

Chromium / Electron#

--ozone-platform-hint=auto --enable-wayland-ime

你也可以用 --ozone-platform=wayland 强制指定 Wayland。

其中 --ozone-platform-hint 是 Chromium 系特有的 Flag,可以用于切换到 Wayland 后端。

Note

可以使用 xeyesextra 判断应用当前是 Wayland 还是 XWayland

如果不行可以追加这个参数

--wayland-text-input-version=3

如果使用终端启动遇到一些带 GPU 字眼的 ERROR,可以追加这个参数禁用 GPU 加速

--disable-gpu-compositing

或者你发现使用上面的 wayland 参数启动后启动变慢,也可以加上试试,因为这些 ERROR 会增加启动时间。


拿 linuxqqaur 举例,

添加参数:

默认情况下发送到桌面的 .desktop 来自软件包,位于 /usr/share/applications。

编辑后的 .desktop 位于 ~/.local/share/applications 下,所以你需要重新发送到桌面。

Exec=linuxqq --ozone-platform=wayland --enable-wayland-ime %U

其他支持 Wayland 后端的应用#

Godot#

在 Godot 编辑器设置中勾选“高级设置”(右上角开关),随后在“运行” -> “平台”中勾选“首选 Wayland”后重启 Godot 即可。


普通 X11 应用#

以 WPS 为例:

在 KDE 菜单编辑器中为所有 WPS 菜单项添加环境变量:

QT_IM_MODULE=fcitx

这会在 ~/.local/share/applications 重新生成新的 .desktop 文件(同时不会影响其他软件)。

已经发送到桌面的需要重新发送一次,否则使用的还是 /usr/share/applications 的 .desktop。

由于 ~/.local/share/applications 的搜索优先级高于 /usr/share/applications,通过 XDG 关联的文件直接打开也应当能工作。

修复 XWayland 下的 Fcitx5 输入法
https://nekoside.com/posts/xwayland-fcitx/
作者
nekoside
发布于
2026-09-17
许可协议
CC BY-NC-SA 4.0
文章目录