适用环境：Ubuntu 22.04 LTS。若系统已经稳定使用 IBus，不必为了“更强功能”强行更换；不要让两个输入法框架同时接管环境变量。

Fcitx5 是输入法框架，本身不等于拼音引擎。Ubuntu 上常用组合是 fcitx5 加 fcitx5-chinese-addons，再用图形配置工具添加“拼音”。

安装

1
2
3

sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-config-qt
im-config -n fcitx5

执行完后注销再登录；若仍不生效，重启一次会更彻底。随后打开应用菜单中的 Fcitx 5 Configuration，点击“添加输入法”，取消“仅显示当前语言”，搜索并添加“拼音”。

使用与检查

默认可用 Ctrl + Space 切换输入法。若快捷键无反应，先在 Fcitx5 配置中检查“全局选项”而不是直接修改配置文件。

1

fcitx5-diagnose | less

诊断报告会显示当前桌面会话、环境变量、已安装组件和冲突配置。特别注意：旧教程常要求手工写入 GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS；Ubuntu 22.04 配合 im-config 时通常不需要重复写入，重复配置反而可能导致应用无法调出候选框。

Wayland 提示

Ubuntu 22.04 的 GNOME 可能运行在 Wayland 会话。多数 GTK/Qt 程序可正常使用 Fcitx5；个别 Electron、Java 或旧版应用若不能输入中文，应先更新应用，或仅为该应用参考其官方 Wayland/Fcitx5 支持说明，不要全局退回到旧框架。

出处

• 原始参考：Fcitx5 输入法设置优化（深度科技论坛）
• 原始参考：Debian 12 安装 Fcitx5 中文拼音输入法（知乎）
• 项目参考：Fcitx 5 Wiki

两篇原始参考分别面向 Deepin 与 Debian；本文已按 Ubuntu 22.04 的软件包名称和桌面流程重新整理。