1. 为什么Wayland下中文输入法成了老大难如果你最近把主力机升级到了 Ubuntu 24.04大概率会遇到一个很尴尬的场景系统装好了浏览器能开终端能用微信也跑起来了结果一敲键盘想打中文——候选框死活不出来。这不是你手残而是 Ubuntu 24.04 默认把显示服务器从 X11 换成了 Wayland而输入法框架和 Wayland 之间的配合跟过去十几年的 X11 时代完全是两套逻辑。我自己从 Ubuntu 20.04 一路用到 24.04中间踩过的输入法坑能写满一页纸。早期在 X11 下fcitx 和 ibus 基本是装上就能用环境变量配好、重启一下候选框就乖乖出来了。但到了 Wayland情况变了输入法不再通过 XIM 协议跟应用通信而是走 Wayland 自己的 text-input 协议或者退一步用 GTK/Qt 的 IM Module。这就导致同一个输入法在 GNOME 原生应用里能用在 Electron 应用里可能就废了在终端里能打在浏览器里又不行。这篇内容就是把我这几年在 Ubuntu 24.04 上折腾中文输入法的经验整理出来重点讲清楚两件事ibus 和 fcitx5 到底该选哪个以及Wayland 下那些让人抓狂的坑怎么绕过去。不管你是刚装完系统的新手还是从 22.04 升级上来发现输入法失灵的老用户都能在这里找到能直接抄的配置方案。我会把每一步的命令、参数、为什么这么配都讲明白而不是甩给你一句装个 fcitx5 就好了。先说结论省得你往下翻Ubuntu 24.04 默认桌面 GNOME Wayland 的组合下fcitx5 是更省心的选择但 ibus 在系统集成度上有它的优势。具体怎么选取决于你用的是什么桌面环境、跑哪些应用、愿不愿意折腾。下面我拆开讲。2. ibus 与 fcitx5 的选型逻辑拆解2.1 两个框架的出身和设计哲学差异要理解为什么会有选型问题得先搞清楚这两个框架的来路。ibusIntelligent Input Bus是 GNOME 生态的亲儿子Ubuntu 默认就带它。它的设计目标是总线式架构——所有输入法引擎作为独立进程挂在 ibus 总线上通过 D-Bus 通信。好处是跟 GNOME 集成得非常好系统设置里直接就有输入源选项加个中文输入法点几下鼠标就行。坏处是它的引擎生态相对单薄除了自带的拼音、五笔第三方引擎不多而且性能上因为要走 D-Bus候选词响应偶尔会有延迟感。fcitx5是 fcitx 的重写版本社区驱动设计上更偏向输入法平台。它支持多种前端协议XIM、GTK IM Module、Qt IM Module、Wayland text-input引擎生态极其丰富——拼音、五笔、仓颉、日语、韩语、越南语应有尽有还有各种云拼音、emoji 输入插件。性能上 fcitx5 用 C 重写后比 fcitx4 快很多候选框响应基本无感。打个比方ibus 像是 GNOME 官方配的标准件装上去严丝合缝但选择少fcitx5 像是万能改装件什么车都能装但有时候需要你自己调螺丝。2.2 Wayland 下两者的实际表现对比这是选型的核心。在 Wayland 会话里输入法要跟应用通信主要有三条路Wayland text-input 协议最正统的方式但协议本身还在演进很多应用没实现完整。GTK/Qt IM Module应用层面加载输入法模块绕过 Wayland 协议。这是目前最可靠的方式。XIM老古董在 Wayland 下通过 XWayland 兼容层工作只对 X11 应用有效。ibus 在 Wayland 下的策略是优先走 GNOME 内置的 Wayland text-input 支持配合 GTK IM Module。因为 GNOME 和 ibus 是同一拨人维护的所以原生 GNOME 应用如 GNOME Terminal、Nautilus、GNOME Text Editor里 ibus 表现很稳。但问题出在非 GNOME 应用上——比如 Firefox、Chromium、VS Code、各种 Electron 应用它们对 Wayland text-input 的支持参差不齐ibus 在这些应用里经常出现候选框不跟随光标、输入延迟、甚至完全无法输入的情况。fcitx5 在 Wayland 下的策略更务实它不指望 Wayland 协议而是主推 GTK IM Module 和 Qt IM Module。只要应用是用 GTK 或 Qt 构建的加载对应模块后就能正常输入。对于 Electron 应用fcitx5 通过设置GTK_IM_MODULEfcitx也能让它们走 GTK 模块。实测下来fcitx5 在 Wayland 下的应用兼容性明显好于 ibus尤其是浏览器和编辑器这类高频应用。我做过一个粗略的对比测试在 Ubuntu 24.04 GNOME Wayland 下同样配置中文拼音输入应用类型ibus 表现fcitx5 表现GNOME 原生应用稳定候选框跟随光标稳定候选框跟随光标Firefox偶发候选框不跟随需重启应用稳定Chromium/Chrome经常无法输入中文稳定VS Code候选框位置偏移稳定Electron 应用微信等大部分无法输入配置后可输入终端GNOME Terminal稳定稳定终端Konsole不稳定稳定这个表不是绝对的跟具体版本、配置都有关系但趋势很明显fcitx5 在 Wayland 下的兼容性覆盖面更广。2.3 什么情况下该选 ibus虽然我整体推荐 fcitx5但 ibus 也不是没有适用场景你只用 GNOME 原生应用如果你日常就是 GNOME Terminal、Nautilus、GNOME 文本编辑器ibus 完全够用而且系统集成度最高不用额外配置。你不想装第三方软件ibus 是系统自带的不用加 PPA、不用装额外包对追求纯净系统的人友好。你在用 Ubuntu 的衍生版且默认就是 ibus比如某些定制版改框架可能引入其他问题。你需要跟 GNOME 的输入源切换快捷键深度集成ibus 跟 GNOME 的 SuperSpace 切换是原生打通的。2.4 什么情况下必须上 fcitx5你重度使用浏览器和 Electron 应用这是 fcitx5 的主场。你需要丰富的输入法引擎比如你想用 rime、中州韵、云拼音、日语输入等。你在用 KDE Plasma 或其他非 GNOME 桌面fcitx5 跟 KDE 集成更好。你从 X11 时代就是 fcitx 用户习惯它的配置方式和快捷键。你遇到 ibus 在 Wayland 下候选框不跟随光标的问题且无法忍受换 fcitx5 是最直接的解法。提示选型不是一锤定音。你可以先试 ibus如果遇到应用兼容性问题再换 fcitx5。但注意两个框架不要同时装同时启用会冲突。3. fcitx5 在 Ubuntu 24.04 Wayland 下的完整配置实操3.1 安装前的环境确认动手之前先确认你的会话类型。打开终端执行echo $XDG_SESSION_TYPE如果输出wayland说明你在 Wayland 会话输出x11则是 X11。Ubuntu 24.04 默认是 Wayland但如果你用的是 NVIDIA 专有驱动可能被自动切到 X11。再确认桌面环境echo $XDG_CURRENT_DESKTOPGNOME 会输出ubuntu:GNOME或GNOMEKDE 会输出KDE。这两条信息决定了后面的配置细节。Wayland GNOME 是最常见的组合也是坑最多的组合下面以它为主讲KDE 的差异我会单独提。3.2 安装 fcitx5 及中文引擎Ubuntu 24.04 的官方源里已经有 fcitx5 了不需要加 PPA。直接装sudo apt update sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5 fcitx5-frontend-qt6这里解释一下每个包的作用fcitx5主程序。fcitx5-chinese-addons中文输入法引擎集合包含拼音、双拼、五笔、仓颉等。fcitx5-frontend-gtk3/gtk4GTK 应用的输入法模块Firefox、GNOME 应用靠它。fcitx5-frontend-qt5/qt6Qt 应用的输入法模块KDE 应用、WPS 靠它。如果你还想用 rime 引擎额外装sudo apt install fcitx5-rime装完之后不要急着重启先把配置做对否则重启后可能进不了输入法。3.3 环境变量的正确配置方式这是 Wayland 下最容易出错的一步。很多人照着老教程在~/.bashrc或~/.profile里写export GTK_IM_MODULEfcitx结果发现对图形应用无效——因为图形应用不是从 shell 启动的读不到这些变量。正确的做法是写到/etc/environment或者用~/.config/environment.d/下的配置文件。我推荐后者更干净mkdir -p ~/.config/environment.d cat ~/.config/environment.d/im.conf EOF GTK_IM_MODULEfcitx QT_IM_MODULEfcitx XMODIFIERSimfcitx EOF这三个变量的含义GTK_IM_MODULEfcitx告诉 GTK 应用加载 fcitx 输入法模块。QT_IM_MODULEfcitx告诉 Qt 应用加载 fcitx 模块。XMODIFIERSimfcitxX11 应用通过 XWayland的输入法标识。注意在纯 Wayland 会话下有些教程会让你设SDL_IM_MODULE和GLFW_IM_MODULE这两个是给游戏和 GLFW 应用的。如果你玩 Linux 原生游戏或者用 GLFW 开发可以加上SDL_IM_MODULEfcitx GLFW_IM_MODULEibus注意 GLFW 目前只认 ibus这是个历史遗留问题即使你用 fcitx5GLFW 应用也得设成 ibus 才能输入。写完之后这些变量会在下次登录时生效。想立即生效可以source一下但图形应用还是得重新登录。3.4 开机自启动的配置fcitx5 需要开机自启否则每次登录都要手动跑。Ubuntu 24.04 下有两种方式方式一用系统自带的 autostartcp /usr/share/applications/fcitx5.desktop ~/.config/autostart/如果~/.config/autostart/不存在就先创建。这个方式简单但有时候 GNOME 会忘记启动它。方式二用 systemd user service推荐fcitx5 自带一个 systemd user unit但默认可能没启用。执行systemctl --user enable fcitx5.service systemctl --user start fcitx5.service然后确认状态systemctl --user status fcitx5.service看到active (running)就对了。实操心得我遇到过 autostart 方式在 GNOME Wayland 下偶尔不生效的情况尤其是系统更新后。systemd user service 更可靠而且可以用systemctl --user restart fcitx5快速重启输入法不用注销。强烈推荐用方式二。3.5 配置输入法引擎和快捷键fcitx5 装好后运行配置工具fcitx5-configtool如果提示命令不存在装一下sudo apt install fcitx5-config-qt打开后你会看到几个标签页Input Method这里添加输入法。点左下角取消勾选Only Show Current Language搜索Pinyin添加。想用双拼就加Shuangpin五笔加Wubi。Global Options设置切换快捷键。默认是CtrlSpace切换中英文CtrlShift切换输入法。如果你用 GNOME注意 GNOME 自己也占用了SuperSpace切换输入源可能冲突。Addons这里可以配置云拼音、emoji 等插件。配置完记得点 Apply。3.6 GNOME 下的额外处理GNOME 有个输入源设置跟 fcitx5 会打架。你需要确保 GNOME 的输入源里只保留 English (US)不要加中文输入法否则会出现两个输入法框架抢键盘的情况。打开 Settings → Keyboard → Input Sources把除了 English (US) 之外的都删掉。另外GNOME 的SuperSpace切换输入源快捷键建议改掉或禁用避免跟 fcitx5 冲突。在 Settings → Keyboard → Keyboard Shortcuts → View and Customize Shortcuts → Typing 里可以改。3.7 重启并验证做完以上步骤注销重新登录或者直接重启。登录后看系统托盘有没有 fcitx5 图标可能是个小键盘或中字。打开 GNOME Terminal按CtrlSpace看能不能切到中文。打开 Firefox同样测试。打开 VS Code测试。如果都正常恭喜你配置成功。如果有问题看下一节的排查。4. Wayland 下中文输入法常见问题与排查实录4.1 候选框不跟随光标这是 Wayland 下最经典的问题。表现是能输入中文但候选框固定在屏幕某个角落不跟着光标走。原因应用没有正确使用 Wayland text-input 协议或者输入法模块没加载。排查步骤确认环境变量生效。在终端执行env | grep IM_MODULE应该看到GTK_IM_MODULEfcitx和QT_IM_MODULEfcitx。如果没有说明 environment.d 配置没生效检查文件路径和语法。确认应用是 GTK 还是 Qt。Firefox 是 GTK理论上加载 GTK 模块后候选框应该跟随。如果不行试试在 Firefox 的about:config里把widget.wayland.text-input-v3相关选项调整一下不同版本选项名不同。对于 Electron 应用试试启动时加参数--enable-wayland-ime。比如 VS Code 可以改 desktop 文件在 Exec 行加这个参数。实操心得候选框不跟随这个问题在 fcitx5 GTK IM Module 的组合下大部分应用是正常的。如果某个应用死活不行先查它是不是用了自己的输入法实现比如某些 Java 应用用 XIM。Java 应用可以加-Dawt.useSystemAAFontSettingson之类的参数但输入法支持要看具体框架。4.2 fcitx5 不开机启动前面提过autostart 方式可能失效。排查systemctl --user status fcitx5.service如果显示inactive或failed看日志journalctl --user -u fcitx5.service -n 50常见原因是环境变量没设好fcitx5 启动时找不到 Wayland 显示。确保~/.config/environment.d/im.conf存在且语法正确。另一个可能是 fcitx5 跟 ibus 冲突。检查是否装了 ibus 且还在运行ps aux | grep ibus如果有 ibus-daemon 在跑禁用它sudo apt remove ibus或者至少不让它自启。但注意卸载 ibus 可能影响 GNOME 的某些功能谨慎操作。4.3 fcitx5 无法输入中文表现是fcitx5 图标在能切换中英文但打出来的还是英文。排查清单检查项命令/操作预期结果输入法引擎是否添加fcitx5-configtool看 Input Method有 Pinyin环境变量是否生效env | grep IM_MODULE有 fcitx应用是否加载模块看应用启动日志无报错是否跟 ibus 冲突ps aux | grep ibus无 ibus 进程fcitx5 是否运行systemctl --user status fcitx5active如果都正常还是不行试试重启 fcitx5systemctl --user restart fcitx5或者用fcitx5 -r替换当前实例。4.4 特定应用无法输入有些应用就是钉子户比如Chromium/ChromeWayland 下需要加启动参数--enable-featuresUseOzonePlatform --ozone-platformwayland --enable-wayland-ime。或者干脆用 X11 模式跑--ozone-platformx11输入法反而正常。WPSQt 应用确保装了fcitx5-frontend-qt5并且QT_IM_MODULEfcitx。微信Linux 版Electron 应用加--enable-wayland-ime参数试试。Java 应用用 XIM确保XMODIFIERSimfcitx并且应用以 X11 模式运行。实操心得遇到顽固应用最省事的办法是让它跑在 XWayland 下。虽然理论上 Wayland 更先进但 XWayland 的输入法兼容性经过十几年打磨反而更稳。你可以在应用启动参数里强制GDK_BACKENDx11GTK 应用或QT_QPA_PLATFORMxcbQt 应用。4.5 输入法切换快捷键冲突GNOME 的SuperSpace和 fcitx5 的CtrlSpace一般不冲突但如果你改过 GNOME 快捷键可能撞车。检查 GNOME 快捷键gsettings get org.gnome.desktop.wm.keybindings switch-input-source如果返回[Superspace]而你又想用这个组合就在 fcitx5 里改。或者直接禁用 GNOME 的gsettings set org.gnome.desktop.wm.keybindings switch-input-source [] gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward []4.6 云拼音不工作fcitx5 的云拼音插件需要联网。如果你在 fcitx5-configtool 的 Addons 里启用了 Cloud Pinyin 但还是不出候选检查网络是否正常。云拼音服务地址是否可达默认是 Google 的国内可能不通。在 Addons 配置里换成国内可访问的服务或者干脆关掉用本地词库。注意云拼音涉及网络请求如果你对隐私敏感建议关闭。本地词库配合用户词频学习日常使用足够了。5. 从 ibus 迁移到 fcitx5 的注意事项5.1 迁移前的备份如果你现在用 ibus想换 fcitx5先备份 ibus 的配置虽然大概率用不上但保险cp -r ~/.config/ibus ~/.config/ibus.bak然后卸载或禁用 ibussudo apt remove ibus ibus-pinyin ibus-libpinyin注意ibus可能被其他包依赖卸载时看清楚提示。如果不想卸载至少禁用它自启systemctl --user disable ibus.service 2/dev/null5.2 清理旧的环境变量检查~/.bashrc、~/.profile、~/.xprofile里有没有旧的GTK_IM_MODULEibus之类的配置有就删掉或改成 fcitx。这些文件里的配置会覆盖 environment.d 的设置导致新配置不生效。5.3 重新登录后的验证迁移完成后注销重新登录。验证顺序fcitx5 是否自启托盘图标。终端能否输入中文。浏览器能否输入中文。常用应用逐个测试。如果发现某个应用不行回到第 4 节排查。5.4 回滚方案万一 fcitx5 在你机器上问题太多想回 ibussudo apt install ibus ibus-libpinyin然后删掉~/.config/environment.d/im.conf重新登录。GNOME 会自动接管输入法。实操心得我建议在迁移前用 Timeshift 或类似工具做个系统快照。输入法配置涉及环境变量、系统服务、应用模块出问题时排查成本不低。有快照的话大不了回滚重来比一点点修配置快得多。6. 一些容易被忽略的细节和进阶技巧6.1 终端下的输入法GNOME Terminal 在 Wayland 下对 fcitx5 支持良好。但如果你用 Alacritty、Kitty 这类 GPU 加速终端可能需要额外配置。Alacritty 需要在配置文件里设key_bindings或者依赖WAYLAND_DISPLAY环境。Kitty 一般开箱即用。如果终端里输入法候选框位置不对试试在终端启动时加--enable-wayland-ime如果支持。6.2 远程桌面和虚拟机在 VMware、VirtualBox 里跑 Ubuntu 24.04Wayland 的输入法问题会更复杂因为虚拟机的显示驱动和输入设备透传可能不完整。我的建议是虚拟机里直接用 X11 会话。登录界面点齿轮图标选 Ubuntu on Xorg输入法问题会少很多。远程桌面如 RDP、VNC同理X11 更稳。6.3 多语言切换如果你需要中英日韩多语言fcitx5 的优势就体现出来了。在 fcitx5-configtool 里添加多个引擎用CtrlShift循环切换。每个引擎可以单独配置快捷键和候选词数量。6.4 词库同步和备份fcitx5 的用户词库在~/.local/share/fcitx5/pinyin/下。换机器时把这个目录拷过去你的输入习惯就带走了。定期备份这个目录比什么都强。6.5 性能调优如果觉得候选词响应慢可以在 fcitx5-configtool 的 Addons 里调整关闭不需要的插件如云拼音、emoji。减少候选词数量默认 5 个可以调到 3 个。关闭预测功能。这些设置对老机器提升明显。7. 我个人的最终配置方案折腾了这么多轮我目前在 Ubuntu 24.04 GNOME Wayland 下的稳定配置是框架fcitx5systemd user service 自启。引擎fcitx5-pinyin 用户词库关闭云拼音。环境变量~/.config/environment.d/im.conf里设GTK_IM_MODULEfcitx、QT_IM_MODULEfcitx、XMODIFIERSimfcitx。GNOME 输入源只留 English (US)禁用SuperSpace切换。快捷键CtrlSpace切中英CtrlShift切引擎。顽固应用Chromium 加--enable-wayland-imeJava 应用跑 X11 模式。这套配置在我日常用的浏览器、编辑器、终端、聊天工具里都没问题。偶尔遇到某个新应用不行基本就是加个启动参数的事。最后分享一个小技巧如果你不确定某个应用为什么输入法不工作用fcitx5-diagnose命令。它会输出一份详细的诊断报告包括环境变量、运行进程、模块加载情况比你自己一条条查快得多。这个命令是 fcitx5 自带的装完就有。输入法这东西配好了就忘了它的存在配不好天天闹心。希望这篇内容能帮你一次配到位把时间花在真正重要的事情上。
