中文输入：从 Fcitx5、拼音引擎到应用中的文字

本篇的完成目标是：你能在一个普通文本框输入“你好，Omarchy”，切回英文，并知道相同操作在某个应用失败时该查哪一层。先打通拼音，再配置词库、双拼或 Rime，能保留一个可靠的对照。

操作依据当前官方文档与固定源码；应用界面名称可能因语言和版本不同。示例是教学流程，未在你的应用组合中实测。

1. 框架、引擎、键盘布局分别做什么？

键盘按键与布局
  → 输入法切换与激活
  → Fcitx5 框架把输入交给选中的引擎
  → 拼音引擎产生候选词
  → 选择并提交文字
  → 应用通过输入协议或模块接收文字

部分	负责什么	不负责什么
键盘布局	按键产生什么键值，例如 US 布局	不把 nihao 转成“你好”
Fcitx5	管理输入方法、状态与应用交互	仅安装框架不代表已选中拼音
Pinyin 引擎	拼音转换、候选词及词典	不决定每个应用通过哪种协议接入
配置工具	添加输入方法、调整热键和引擎选项	不是必须一直打开的输入服务
应用接入	通过 Wayland 或工具包模块接收预编辑与提交	不由“安装了词库”保证一定可用

Caps Lock 的 Compose 字符输入也不等于切换中文引擎。系统键盘布局、Compose、拼音和 Rime 是不同功能。输入与显示组件

2. 先检查，不假定每台电脑都缺少引擎

pacman -Q fcitx5 fcitx5-chinese-addons fcitx5-configtool

已安装的包显示名称与版本；缺失的包会报告未找到。固定源码的核心清单已经包含 fcitx5-chinese-addons，但实际安装、旧版本和个人删减可能不同。软件包依据

需要补装拼音引擎或工具时，使用官方安装入口：

omarchy pkg add fcitx5-chinese-addons fcitx5-configtool

阅读事务列出的软件包变更。安装完成解决的是“程序文件存在”，还要确认输入引擎已加入当前列表，并能在会话中工作。

3. 把拼音加入当前输入方法

fcitx5-configtool

查看当前输入方法列表。如果已有 Pinyin，先不要重复添加。否则在添加界面寻找 Pinyin；语言筛选可能隐藏其他语言的方法，需要取消仅显示当前语言的筛选。

保留直接英文输入需要的键盘项，加入拼音并应用设置。记录修改前的列表顺序和热键；以后需要撤销时，能恢复原组合。工具中有“可添加的引擎”与“当前正在使用的列表”，只有出现在前者还不够。

固定源码提供简体中文 Pinyin 预设；如果你通过 Omarchy 的语言设置入口配置，应检查现有选择，再决定是否需要手动调整，避免反复覆盖同一份配置。预设依据

4. 切换键：先匹配当前版本

本源码把 Super + I 绑定到向前切换输入语言，Super + Shift + I 向后切换。Fcitx 配置还提供单独 Shift 在引擎与直接输入间切换的行为；实际效果取决于当前引擎与个人设置。

omarchy menu keybindings --print

在本机清单中确认绑定，再测试。不要直接照旧教程把 Ctrl + Space 当作全局中文切换键：本源码把它留给终端复用器等操作，并在终端中处理直接输入。桌面绑定 · Fcitx 热键预设

如果个人改过切换键，记录旧值，一次只修改一个组合；先验证两个应用，再决定长期保留。全局桌面快捷键和应用内部快捷键可能有冲突。

5. 完成一次输入，而不只观察图标

在普通文本输入框中操作，不使用密码框或快捷键录制框：

1. 点击输入框，确认光标在里面。
2. 切换到拼音，输入 nihao。
3. 观察预编辑文字或候选框，选择“你好”，确认文字已提交到输入框。
4. 输入中文标点，再切回直接英文输入，输入 Omarchy。
5. 用 Backspace 修改内容，确认不是只有候选框变化而应用没有接到文字。

看到了什么	已验证的环节
切换状态变化	选中输入方法发生变化
拼音出现候选词	引擎正在处理输入
“你好”出现在应用里	应用收到文字提交
切回后可以输入英文	直接输入路径正常

图标变化不代表提交成功；候选框位置不正常，也不等于引擎没有工作。

6. 浏览器、终端、编辑器怎样分别验收？

测试位置	操作与注意点
浏览器普通文本框	输入同一句话，记录候选框与提交结果
Foot 终端的空闲提示符	只输入短句观察，不按 Enter 执行，随后清除；输入中文不能测试 Shell 命令是否有效
编辑器临时文档	进入可以插入文字的模式再测试，特别注意 Neovim 的普通模式与插入模式不同

在三个位置使用同一段短句，并记录“可切换／有候选／可提交”。有一个位置能完整成功，就有了对照；其他位置失败时阅读按应用定位输入法问题，不先重装整套输入法。

如果文字已经提交但显示为方框，先确认是字体缺字问题，而不是继续修改切换键。候选框偏移则记录显示器缩放、应用后端和发生位置。

7. 配置与撤销的边界

更改热键或引擎前记录旧值；做较多修改前，可以保存 Fcitx 配置目录：

cp -a -i ~/.config/fcitx5 ~/.config/fcitx5.before-input-edit

只在原目录存在时执行；目标如果已存在，换一个新名称，不要把多次配置递归合并后当作原始副本。-a 保留目录结构与属性，-i 在覆盖文件时询问。

简单撤销优先通过配置工具恢复旧列表与热键。确需恢复目录时，先按当前会话管理方式停止输入服务、另存现有目录，再按备份工具的流程恢复并重新登录；不要在服务可能写回设置时直接覆盖整个目录。

词典与个人输入数据还可能位于 ~/.local/share/fcitx5，具体由引擎决定；一份配置目录不等于完整用户词库备份。Rime 的方案与词典属于另一个引擎的配置，不能把拼音引擎的文件当作 Rime 方案。完整备份见备份教程。

来源与适用范围

核对于 2026-10-12：Omarchy 输入说明、固定提交的输入切换绑定、Fcitx 配置、Fcitx5 基础配置。本文处理基础拼音使用，不把某个浏览器版本的启动参数当作全应用修复方法。