候选框不显示但拼音能输、图标正常，说明问题在UI渲染层：先检查fcitx5-frontend组件是否装全（gtk/qt/wayland），再排查fcitx-qimpanel进程是否僵死，接着验证GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS环境变量是否正确写入~/.profile并重登录，最后检查classicui.conf中透明度、坐标或主题配置异常。
候选框不显示，但拼音能输、状态栏图标正常，说明输入法框架已启动、引擎在工作，问题出在 UI 渲染层——不是“没输入法”，而是“窗口画不出来”。
fcitx5 候选框消失：先看 fcitx5-frontend 是否装全
fcitx5 的候选框由前端模块负责绘制，不同桌面环境依赖不同组件：
- GTK 程序（如 GNOME Terminal、gedit）需要
fcitx5-gtk - Qt 程序（如 Qt Creator、qBittorrent）需要
fcitx5-qt - Wayland 下还可能缺
fcitx5-wayland（尤其 KDE Plasma 或 Hyprland）
常见错误现象：终端里能打拼音，但浏览器或 VS Code 里候选框完全不出现；或者只在部分程序里有效。用 apt list --installed | grep fcitx5 检查是否漏装。Ubuntu/Debian 系建议一次性补全：sudo apt install fcitx5-gtk fcitx5-qt fcitx5-wayland。装完必须注销重登录，否则新模块不加载。
fcitx-qimpanel 崩溃导致候选框静默失效
fcitx-qimpanel 是 fcitx4 下负责绘制候选框的独立进程，它挂了，输入法还能响应按键、切换中英文，但候选框彻底不渲染——托盘图标照常，极具迷惑性。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
- 执行
killall fcitx-qimpanel，等 2 秒后立刻在文本框里敲拼音（如zhong），看候选框是否闪现 - 若恢复，说明是它僵死；可加到开机自启：
systemctl --user enable --now fcitx-qimpanel - 若无效或频繁崩溃，直接卸载：
sudo apt remove fcitx-ui-qimpanel，再注销重登录，系统会 fallback 到更稳定的fcitx-classic-ui
环境变量没生效，应用根本看不到 fcitx
即使 fcitx 进程在跑，如果 GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS 这三个变量没设对，GTK/Qt/X11 程序压根不会把输入事件交给它处理，自然没有候选框。
- 检查当前值：
echo $GTK_IM_MODULE $QT_IM_MODULE $XMODIFIERS，正确应为fcitx5 fcitx5 @im=fcitx5（fcitx5）或fcitx fcitx @im=fcitx（fcitx4） - 变量必须写进用户级 shell 配置（如
~/.profile或~/.pam_environment），不能只写在~/.bashrc里——后者只对终端生效，图形会话不读它 - 写入后必须注销重登录，
source ~/.profile不起作用
候选框被渲染到屏幕外或透明度为 0%
尤其是高 DPI 屏幕、多显示器、或用了自定义主题时，fcitx5 的经典界面可能把候选框坐标算错，或从配置里读到了 alpha: 0 这类值，结果框存在但不可见。
- 临时测试：运行
fcitx5-configtool→ 进入“外观”页 → 把“透明度”拖到 100%，“位置”设为“跟随光标” - 若仍不显示，尝试换主题：在同一页把“UI 主题”从当前值改成
default或dark，避免 SVG 渲染异常 - 极端情况可手动重置：
rm -r ~/.config/fcitx5/conf/classicui.conf，重启 fcitx5（fcitx5-remote -r）让其重建默认配置
真正卡住人的地方，往往不是“没装对包”，而是环境变量写错文件、qimpanel 进程僵死却不自启、或者 UI 配置里一个透明度被设成 0 却找不到开关——这些点不爆出来，重装十遍也没用。
