先确认fcitx5服务是否运行:执行fcitx5-remote -s,返回0说明服务正常;若命令未找到则需sudo apt install fcitx5 fcitx5-pinyin;无响应则systemctl --user restart fcitx5。再检查wayland/x11会话、候选框设置、安全软件干扰、配置文件损坏(mv ~/.config/fcitx5 ~/.config/fcitx5.bak后重启)及qt应用缺失插件(sudo apt install fcitx5-frontend-qt5)和环境变量。

输入法候选框不显示,多数情况不是输入法没装好,而是服务、配置或环境没跑通。核心得让 fcitx5 正常通信、正确渲染、被应用识别到。
先确认 fcitx5 服务是否活着
状态栏图标灰显、Ctrl+Space 没反应,大概率是守护进程挂了。别急着重装,先试重启:
- 打开终端,执行:fcitx5-remote -s —— 这会强制切换一次输入法,成功返回 0 就说明服务在跑
- 如果提示 command not found,说明 fcitx5 没装:运行 sudo apt install fcitx5 fcitx5-pinyin
- 如果命令能输但没反应,再执行:systemctl --user restart fcitx5,等几秒后重试快捷键
检查候选框被谁“挡住”或“禁用”了
候选框本质是个悬浮 UI 窗口,Wayland 下容易因 GPU 渲染异常失活,X11 下也可能被其他组件干扰:
- 进 控制中心 → 显示 → 图形协议,确认当前使用的是 X11(非 Wayland)——多数候选框问题在 Wayland 会话下更常见
- 右键任务栏输入法图标 → “设置” → 查看是否勾选了“显示候选窗口”或“启用候选条”,有些版本默认关掉了
- 临时关闭安全软件、远程桌面工具(如向日葵、AnyDesk),它们有时会拦截 fcitx5 的窗口创建请求
重置配置,排除文件损坏
~/.config/fcitx5/ 下的 conf 文件出错,会导致候选框逻辑加载失败,但输入法图标还能亮:
- 终端执行:mv ~/.config/fcitx5 ~/.config/fcitx5.bak
- 然后重启 fcitx5:fcitx5 & 或注销重登录
- 系统会自动生成干净配置,再进 fcitx5-configtool 添加一次 Chinese (Pinyin),候选框通常就回来了
针对 Qt 应用单独处理
WPS、QtCreator、微信 Linux 版等 Qt 程序,经常有候选框不弹、打字没反应的问题,关键缺的是前端插件和环境变量:
- 确保已安装:sudo apt install fcitx5-frontend-qt5
- 检查 ~/.profile 末尾是否有这三行(没有就加上):
export QT_IM_MODULE=fcitx5
export GTK_IM_MODULE=fcitx5
export XMODIFIERS=@im=fcitx5
然后运行 source ~/.profile - 对 Qt 程序还可额外加启动参数测试:QT_QPA_PLATFORMPLUGINPATH=/usr/lib/qt5/plugins ./your-app











