翻译输入法 Linux 打不出字？IBus/Fcitx 框架与环境变量排查

Linux 上三类问题常被混成一句「输入法坏了」。

翻译输入法 Linux 能装却打不出字：安装包或组件已落盘，列表里可能看得到，但普通文本框无候选、无上屏，或切过去键盘像死的。主因多在 IBus/Fcitx 框架是否加载、当前桌面会话与输入相关环境是否一致。

候选正常但就是不出翻译结果——走「打不出翻译结果」。有候选但语种/方向拧了——走候选语言错乱与源目标配对排查。只有某几个快捷键失灵——走热键冲突。卡顿、风扇狂转而字能打——走 CPU/预取排查。FAQ 里的发行版支持句只是范围摘要，详细分流见 Linux FAQ 与框架指南对接文。

三十秒自检：用桌面自带「文本编辑器」类应用（不是带自有输入栈的 IDE）试打。完全无候选 → 继续本文；有候选无译文 → 换专文。别先卸载重装。

同一台机器装了两个框架时，菜单里“有”不等于当前会话在用它。

到系统设置或桌面的「区域与语言 / 键盘 / 输入法」相关页，看当前启用的是 IBus、Fcitx 还是 Fcitx5。名称以你发行版桌面环境文档为准，不要凭论坛截图硬套菜单路径。

打开对应框架的配置界面，看翻译输入法组件是否已添加、是否启用。列表没有该项：先回下载页核对 Linux 说明与来源，再对照站内 IBus/Fcitx 指南的「组件是否出现」步骤——不要猜测 apt 包名去补装。

列表已有却仍无击键反应：多半是会话未重载，或当前登录会话绑的是另一个框架。保存工作后注销并重新登录（或按桌面文档重启输入法守护进程），再测短句。

IM 模块变量错了，表现为「框架看着正常，应用里死寂」。

Linux 输入常依赖会话级变量（常见讨论会提到 GTK/Qt IM 模块、输入法守护相关变量等）。具体该设哪些、写在用户配置还是桌面会话脚本，以你所用桌面环境的官方文档为准；本站不杜撰某发行版的 export 清单。

排查时只做「对照」：桌面文档要求的变量名，是否与当前会话一致；是否在 Wayland 会话里却沿用了仅适用于 X11 的旧配置。不一致时，按桌面文档修正会话配置，而不是在每个终端窗口临时 export 一遍。

改完会话级配置后，必须重新登录再验收。只在某个终端里能打、图形应用不能打，说明变量只进了 shell，没进桌面会话——这是配置位置问题，不是输入法包损坏。

会话协议一变，昨天还能用的配置今天会静默失效。

同一发行版可在 Wayland 与 X11 间切换登录。若只在某一种会话打不出字，优先查该会话下框架是否支持、桌面文档对 IM 的说明是否区分协议，而不是反复重装翻译输入法。

仅浏览器或 Electron 应用无候选、系统文本框正常：先怀疑应用自带输入/快捷键层，再查全局框架。热键被占走快捷键文；全局无候选才继续抠环境变量。

平板模式、触摸屏屏幕键盘开启时，有的桌面会暂时改写输入路由。先关屏幕键盘，用外接键盘在文本框复测，避免把「屏幕键盘抢焦点」当成框架坏了。

两边都叫「打不出字」，清单完全不同。

macOS：系统设置里输入监控、辅助功能等隐私项未勾选时，输入源能选却读不到键——见 macOS 隐私专文。

Linux：没有同等的「输入监控」开关叙事；等价检查是「哪个框架在跑、组件是否在框架列表、会话环境是否与桌面文档一致」。把 Mac 的隐私步骤搬到 Linux 只会空转。

双系统用户尤易混：昨天在 Mac 开了输入监控，今天在 Linux 却去翻「辅助功能」类翻译教程。平台对上号再动手。

重装修不好「会话绑错框架」和「变量只进了 shell」。

验收：① 确认当前框架唯一且正在运行；② 框架列表中有翻译输入法并已启用；③ 按桌面文档核对会话级 IM 相关环境后重新登录；④ 系统文本框能稳定出候选并上屏；⑤ 再测常用办公/浏览器。①–③ 失败留在本文与 IBus/Fcitx 指南；有候选无译文分流 not-working；有候选但语种错分流 wrong-candidate-language；卡顿分流 high-cpu。

五步仍无候选：回下载页确认 Linux 包与发布说明，并走来源核对指南，避免叠加第三方「一键修复」脚本。

支持范围与阅读顺序见 Linux FAQ 分流；逐步启用见站内 Linux 框架指南；本文只覆盖「能装却打不出字」的框架与环境层。