Omarchy 中文输入法：Fcitx5、Rime 与中文字体配置
在 Omarchy 和 Wayland 中安装、启用并排查 Fcitx5、Rime、简体中文输入、双拼及 CJK 字体，避免候选框和乱码问题。
AMZDIR Editorial · 发布 · 更新
在 Omarchy 中可靠输入中文需要同时满足三件事：输入法框架正常启动、目标应用连接到输入法、字体包含所需汉字。只安装一个 Rime 包并不能自动解决候选框或方框字问题。
先选择输入方案
| 需求 | 建议组件 |
|---|---|
| 拼音、双拼、常见中文方案 | Fcitx5 + Chinese Addons |
| 使用 Rime 方案与同步词库 | Fcitx5 + Rime |
| 只解决汉字显示为方框 | Noto CJK 或思源系列字体 |
使用 Super + Space → Install → Package 搜索，或逐个运行：
omarchy pkg add fcitx5
omarchy pkg add fcitx5-configtool
omarchy pkg add fcitx5-chinese-addons
omarchy pkg add fcitx5-rime
omarchy pkg add noto-fonts-cjk普通拼音可只装 Chinese Addons；使用 Rime 再装 fcitx5-rime。包名变化时以菜单和 Arch 官方仓库搜索结果为准，不要改用 Ubuntu 的 apt 命令。
官方入口：Fcitx 5、Rime、Noto CJK、Nerd Fonts。这些链接分别对应输入框架、输入方案、中文字体覆盖和终端图标字形；不要把四类问题混成一次全量配置修改。
AUR 方案需要审阅
官方仓库没有的词库或主题可能来自 AUR。AUR 内容并非 Arch 团队审核的软件包；安装前阅读 PKGBUILD、来源、维护时间和用户评论。
启动并添加输入法
安装后先手动启动并确认进程，再打开配置工具：
fcitx5 -d
pgrep -a fcitx5
fcitx5-configtool然后：
- 确认 Fcitx5 随图形会话启动；
- 在输入法列表加入键盘布局和目标中文输入法；
- 为中英文切换设置不会与 Omarchy 全局热键冲突的组合键；
- 注销并重新登录，让所有应用读取新会话环境；
- 分别在浏览器、终端、编辑器和 Electron 应用中测试。
重新登录后若 Fcitx5 没有自动启动，可从应用菜单启动一次并检查当前会话的 autostart 设置；不要同时在多个启动文件中重复运行 fcitx5 -d。
不要把网上旧教程中的环境变量一次性粘进所有启动文件。GTK、Qt、Electron 与 Wayland 的输入法支持会随版本变化；只有目标应用无法连接时，才根据 ArchWiki Fcitx5 的当前说明补充会话变量。
如果你还需要按物理键盘或应用切换 XKB 布局，可查看社区 Keyboard Layout Switcher。它管理键盘布局而不是中文输入法；启用时要避免和 Omarchy 官方布局组件、keyd 或旧 Omakeyd 规则重复接管。
配置 Rime 与双拼
选择 Rime 后，先让默认方案成功输入，再加入雾凇拼音、双拼或自定义词库。Fcitx5 的 Rime 用户目录通常是 ~/.local/share/fcitx5/rime。修改前备份：
mkdir -p ~/.local/share/fcitx5
if [ -d ~/.local/share/fcitx5/rime ]; then
cp -a ~/.local/share/fcitx5/rime ~/.local/share/fcitx5/rime.backup
fi目录尚不存在时命令会跳过复制。用户配置应纳入私有备份，不直接修改 /usr/share 下由软件包管理的系统文件。
调整流程：
- 备份现有 Rime 用户目录；
- 每次只增加一个方案或补丁；
- 重新部署 Rime；
- 在普通文本框和终端各测试一次；
- 出错时回退最近一个文件，而不是删除全部词库。
同步词库可能包含姓名、地址和项目名。使用第三方同步服务前检查隐私边界，公开求助时不要上传完整用户词库。
设置中文字体与回退
Omarchy 的 Style → Font 主要面向全局等宽字体；中文正文还依赖 fontconfig 回退。安装字体后刷新并检查匹配：
fc-cache -fv
fc-match sans-serif:lang=zh-cn
fc-match monospace:lang=zh-cn
fc-list :lang=zh family | sort -u | head -30再用浏览器、终端和编辑器分别检查：
- 简体、繁体和标点是否正常；
- Nerd Font 图标是否仍可显示；
- 中英文基线与字重是否可读；
- 代码中的全角/半角字符是否容易区分；
- PDF 和办公文档是否使用了预期字体。
不要用删除系统字体的方式强迫回退。需要固定优先级时，建立最小的用户级 fontconfig 覆盖，并记录原因。
常见问题定位
先生成诊断报告：
fcitx5-diagnose > ~/fcitx5-diagnose.txt报告可能包含会话路径和环境信息，公开前先脱敏。
| 现象 | 优先检查 |
|---|---|
| 托盘没有输入法 | Fcitx5 是否在当前图形会话运行 |
| 有图标但不能输入 | 当前输入法列表、切换键和应用协议支持 |
| 浏览器可用、终端不可用 | 终端类型及其 Wayland/输入法设置 |
| 候选框位置错误 | 缩放、Electron/Wayland 参数和应用版本 |
| 汉字显示为方框 | CJK 字体安装与 fontconfig 回退 |
| 更新后配置失效 | 用户覆盖是否被重命名为 .bak，以及当前官方迁移说明 |
继续阅读显示、网络与声音配置；系统级异常按故障排查顺序保存日志再处理。