适用环境：Ubuntu 24.04 + GNOME + Wayland
目标：从 IBus 智能拼音切换到 Fcitx5，并解决 GNOME Activities 搜索框不显示候选词的问题。
一、先确认当前使用的输入法框架
可以先执行：
fcitx5 --version
fcitx --version如果提示命令不存在，再检查当前已安装的输入法相关包：
dpkg -l | grep -E 'fcitx|ibus'如果你看到类似：
ibus
ibus-libpinyin
那么说明当前使用的是：
IBus + ibus-libpinyin
也就是 Ubuntu / GNOME 中常见的“智能拼音”。
二、安装 Fcitx5 核心和中文拼音插件
执行：
sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-config-qt这些包的作用：
fcitx5 Fcitx5 核心
fcitx5-chinese-addons 中文输入法插件，包含 Pinyin
fcitx5-config-qt Fcitx5 图形化配置工具
三、把系统输入法框架切换到 Fcitx5
运行：
im-config如果首先出现：
Do you explicitly select the user configuration?
选择：
Yes
然后在输入法框架列表中选择：
fcitx5
完成后：
注销当前用户，然后重新登录。
四、确认 Fcitx5 已经正常启动
重新登录后执行：
ps aux | grep fcitx5 | grep -v grep如果能看到 fcitx5 进程，说明已经正常启动。
也可以执行：
fcitx5 --version确认命令已经可用。
五、添加拼音输入法
运行：
fcitx5-configtool在输入法配置界面中：
- 点击添加输入法
- 搜索
Pinyin - 添加
Pinyin
这个拼音输入法来自：
fcitx5-chinese-addons
添加之后，就可以使用 Fcitx5 拼音输入中文。
六、GNOME Wayland 下 Activities 搜索框不显示候选词
在 Ubuntu 24.04 的 GNOME + Wayland 环境中，可能出现这种情况：
普通应用中可以正常输入中文
GNOME Activities 搜索框中也能输入
但是不显示候选词窗口
Fcitx5 启动后可能会弹出类似提示：
Wayland Diagnose
It is recommended to install Input Method Panel GNOME Shell Extensions to provide the input method popup.
这表示需要安装 GNOME Shell 的输入法面板扩展。
推荐安装：
Input Method Panel
它的作用是让 GNOME Shell 自己显示 Fcitx5 的候选词窗口。
七、安装 GNOME 扩展管理工具
为了方便安装 Kimpanel，可以安装：
sudo apt install gnome-browser-connector gnome-shell-extension-manager这两个包分别用于：
gnome-browser-connector：让 extensions.gnome.org 可以和本机 GNOME Shell 通信
gnome-shell-extension-manager：图形化搜索、安装、启用和禁用 GNOME 扩展
它们不是 Fcitx5 本体，只是 GNOME 扩展管理工具。
八、安装 Input Method Panel
8.1 推荐直接运行：
extension-manager打开之后：
- 进入
Browse - 搜索
Input Method Panel - 安装并启用
注意：这里直接搜索
Input Method Panel。如果搜索Kimpanel没结果是正常的。
8.2 也可以通过 GNOME Extensions 网站安装：
如果浏览器弹出：
Open xdg-open?
选择：
Open xdg-open
随后在“打开方式”中选择：
Extension Manager
即可交给扩展管理器安装。
九、确认 Input Method Panel 是否安装成功
执行：
gnome-extensions list | grep -i kimpanel如果看到类似：
kimpanel@kde.org
说明已经安装。
进一步检查状态：
gnome-extensions info kimpanel@kde.org重点确认：
State: ACTIVE
如果没有启用，可以执行：
gnome-extensions enable kimpanel@kde.org然后再次：
注销当前用户，再重新登录。
之后再测试 GNOME Activities 搜索框，候选词窗口通常就可以正常显示。
十、最终结构
配置完成后，大致结构如下：
Ubuntu 24.04
└── GNOME
└── Wayland
└── Fcitx5
├── fcitx5-chinese-addons
│ └── Pinyin
└── GNOME Input Method Panel
└── 负责 GNOME Shell / Activities 中显示候选词而原来的输入法结构是：
IBus
└── ibus-libpinyin
└── 智能拼音十一、暂时不要急着卸载 IBus
建议先保留：
ibus
ibus-libpinyin等确认 Fcitx5 在以下场景都正常使用后，再考虑清理旧组件：
- 浏览器
- Terminal
- VS Code
- GNOME Activities 搜索
- GTK 应用
- Qt 应用
Ubuntu GNOME 与 IBus 的集成比较深，所以没有必要为了使用 Fcitx5 而强行卸载整个 IBus。
十二、常用检查命令
查看 Fcitx5 是否运行：
ps aux | grep fcitx5 | grep -v grep查看版本：
fcitx5 --version打开配置工具：
fcitx5-configtool查看 GNOME 扩展：
gnome-extensions list检查 Input Method Panel：
gnome-extensions list | grep -i kimpanel查看 Input Method Panel 状态：
gnome-extensions info kimpanel@kde.org运行 Fcitx5 诊断：
fcitx5-diagnose总结
Ubuntu 24.04 下，从 IBus 智能拼音切换到 Fcitx5 的核心步骤就是：
安装 Fcitx5
→ im-config 切换到 fcitx5
→ 注销重新登录
→ fcitx5-configtool 添加 Pinyin
→ 安装 Input Method Panel
→ 再次注销重新登录这样可以获得较完整的 Fcitx5 中文拼音体验，并改善 GNOME Wayland 下候选词窗口的显示问题。
Edit by ChatGPT
Comments NOTHING