部分应用不能输入中文：先定位失败的环节

“不能输入中文”可能表示切换键无效、没有候选词、候选词不能上屏，也可能只是文字显示成方框。先把现象分清，才能避免修错层次。如果还没有一个能输入的应用，先完成基础拼音教程。

本篇依据源码与上游文档设计排查流程，没有把某个社区帖子中的应用参数当作通用修复。

1. 用同一句话建立对照

在普通浏览器文本框、Foot 空闲提示符和编辑器临时文档输入 nihao，选择“你好”，再切回英文。终端不要按 Enter 执行测试文字；Neovim 先进入插入模式。

观察点	记录什么	为什么有用
切换	按键前后选中的方法是否改变	区分按键与后续输入处理
候选	拼音有没有候选词	区分引擎处理与文字提交
提交	选中的文字有没有进入应用	区分框架与应用接入
显示	是方框、乱码还是候选位置偏移	不把显示问题当作引擎缺失

例如“浏览器可切换、有候选、能上屏；编辑器可切换、有候选、不能上屏”比“中文坏了”更能缩小范围。不要从不同应用的图标外观推断它们使用了同一条输入路径。

2. 所有应用都失败：检查会话与引擎

在已经登录的图形桌面内打开终端查询：

systemctl --user status omarchy-fcitx5 --no-pager
pacman -Q fcitx5 fcitx5-chinese-addons

服务名对应本文固定源码。旧安装或自行管理的 Fcitx 会话可能没有这个单元；“unit not found”不直接等于 Fcitx 未安装。

当前服务与图形会话绑定，并要求 Wayland 环境。通过 SSH 或未进入图形会话的文本控制台观察它未启动，不能据此判断桌面输入法故障。会话服务源码

服务运行后，用 fcitx5-configtool 确认 Pinyin 在当前列表。包已安装、服务运行、引擎选中是三个独立条件。仍有故障时查看本次启动日志：

journalctl --user -b -u omarchy-fcitx5 --no-pager

不要额外加入第二个自启动 Fcitx 实例。若确定只是现有服务刚刚异常，先保存正在输入的内容，再重启已有服务：

systemctl --user restart omarchy-fcitx5

这会中断输入和正在组合的文字。完成后重做同一句话的测试；反复崩溃时保留日志，不用循环重启代替定位。

3. 切换无效：查焦点与按键冲突

先点入真实可编辑的字段，不用密码框或快捷键录制框。核对本机快捷键清单与 Fcitx 设置。本源码的桌面切换是 Super + I，不是假定 Ctrl + Space；详见切换键说明。

如果通过输入法菜单选择 Pinyin 可以输入，但按键不能切换，优先调查按键路径。临时换一个组合时记录旧值，分别测试两个应用，然后恢复。应用补全快捷键可能与输入法切换冲突；一处失败不说明引擎必须重装。

4. 只有一个应用失败：检查它怎样接入

Fcitx 与应用之间可以使用原生 Wayland 文本输入协议，也可以通过工具包的输入模块；XWayland 应用又有自己的接入条件。应用名称相同也可能因版本、启动方式或运行后端不同而改变行为。

首先完全退出出问题的应用，保存文件并确认后台实例也已结束，然后从平时的桌面入口重新启动。之前启动的进程可能还使用旧环境，仅关闭一个窗口不一定重启了整个应用。

可收集终端看到的环境：

printenv WAYLAND_DISPLAY DISPLAY QT_IM_MODULE GTK_IM_MODULE XMODIFIERS
pacman -Q fcitx5-gtk fcitx5-qt

这只说明当前终端的环境和系统模块包；不证明桌面启动的应用继承了相同值，也不证明自带 Qt 的商业应用使用系统插件。部分变量无输出不一定异常，尤其不能把没有 GTK_IM_MODULE 直接当作故障。

本源码的会话环境设置 QT_IM_MODULE=fcitx 与 XMODIFIERS=@im=fcitx，没有在该文件中强制设置 GTK_IM_MODULE。环境源码

上游说明不同工具包和后端的要求不同，且提醒 Chromium/Electron 的默认行为与参数会变化。对于单个应用，先确定版本、实际后端与其支持的输入方式，再按该应用的当前文档做一次局部测试。记录原启动参数，无改善就撤销；不要一次把网上所有环境变量写进全局配置。Fcitx Wayland 接入说明

5. 文字方框、候选框偏移和个别字段失败

症状	优先检查	有用的对照
已提交中文显示成方框	应用字体是否含汉字	将同一文字放到另一个应用显示
候选框偏移，但能提交	应用后端、缩放、输入框位置	同一应用移到另一屏，记录现象是否跟随
普通字段可用，密码框不出现候选	字段是否禁用输入法	用普通文本框验证，不公开真实密码
编辑器只在某种模式失败	是否处于文字插入模式、是否有按键映射	临时文档、同一模式、同一短句

候选框偏移时，记录每块屏幕的缩放与应用所在屏幕，参考显示器教程。不要为了只发生在一个应用的偏移先改变所有显示器缩放。

6. 怎样读诊断报告与求助？

fcitx5-diagnose

它收集系统、会话、前端模块和配置信息，不会自动修复所有提示。重点读与症状有关的部分：服务未运行、当前引擎列表、所用应用对应的输入模块。没有使用的工具包缺模块，不一定解释眼前问题。

Wayland 前端的输入上下文不一定逐个列出应用名称，不能把“报告里没有这个应用名”单独当作未接入的证据。上游报告阅读指南

求助时给出：Omarchy 与应用版本、引擎、启动入口、可正常输入的对照应用、三个观察点、是否与缩放或睡眠有关。分享报告前检查用户路径与环境内容。成功标准是普通字段中能完成切换、候选、提交、英文返回，并且重新启动应用后仍可用；临时热键与启动参数也应恢复或明确记录。

来源与适用范围

核对于 2026-10-12：Omarchy 输入指南、Fcitx5 诊断、Wayland 接入、固定提交的会话服务。应用兼容性需要按具体版本验证，本篇没有承诺某组参数对所有应用有效。