常见问题
安装与启用
Q: 安装后键盘能弹出，但打不出汉字
这是预期状态，不是故障。 本版不预置任何输入方案，需要自己放入 Rime 方案并部署一次。步骤见 快速上手 第零步：放入 *.schema.yaml + 词典 → default.custom.yaml patch schema_list → 中州韵设置 执行 部署。
Q: 安装了主程序，但在系统设置里找不到 Fcitx5.fx.rime
通常是系统未刷新输入法列表。重启设备或在 设置 → 应用管理 中强行停止后再试。另外注意本版包名是 org.fcitx.fcitx5.android.fx.rime，与上游 / fxliang 是并存的不同应用，确认你在系统输入法列表里选的是本版。
Q: 需要再装 Rime 插件吗
不需要。 Rime 引擎已内置在主 APK 里，本项目也没有任何插件 APK。若你看到"安装 rime 插件"的说法，那是 fxliang / 上游的流程，不适用于本版。
部署与方案
Q: 部署失败
常见原因按顺序排查：
schema_list里列了不存在的方案——确认schema_id与文件名一致；- YAML 语法/缩进错误——可临时移走最近修改的
*.custom.yaml再试； - 方案依赖的词典文件缺失。
Q: 修改 YAML 后没有变化
Rime 配置一般需要重新部署才生效。确认改的是当前 profile 的用户数据目录（data/rime），而不是旧应用、旧 profile 或只读的内置目录。
Q: 刚切回输入法时，前几个字母直接出现在文字里
这是旧版本的 bug（部署期间的按键被漏给输入框），2026-09-28 及之后的构建已修复：现在配置用内容指纹判断是否需要部署，部署期间按键只丢弃并在键盘上显示「正在部署」。请更新到最新版本。
Q: 词库 / 用户词典没有立即同步
为避免退出输入法时长时间卡顿，本版不会在每次退出时强制执行完整 Rime 同步。需要保证落盘时，请在 中州韵设置 中主动执行同步，并定期 导出用户数据。
输入体验
Q: 候选词不出现（已放入方案）
- 确认当前不在英文状态（语言键短按切换中英文）；
- 打开 中州韵设置，确认
schema_list非空并已重新部署； - 检查候选栏是否被遮挡。
Q: 语言键不能切换中英文
本版语言键短按是向 Rime 发送一次 Shift，实际行为由当前方案的 ascii_composer / switch_key 配置决定；长按是 Rime 方案选单。想切换到其他 Android 输入法，请长按工具栏的语言按钮。详见 Rime 引擎（内置）。
Q: 长按退格删完编码后不再继续删正文
这是有意设计：防止连续退格越过编码区边界误删正文。松手后再按退格即可正常删除正文。需要一次清空整个输入框时，长按退格进入连删后上滑到提示条区域即可。
Q: 空格键的划动动作配置了却不生效
空格键划动与 虚拟键盘 → 按键行为 → 划动空格键以移动光标 互斥，开关优先。想使用自定义划动动作，先关闭该开关。详见 SpaceKey。
自定义与配置
Q: 自定义词 / 布局 / 主题丢失了
应用私有目录的数据会随卸载一并删除。重大变更前请使用 数据与备份 → 导出用户数据 备份。
Q: 主题导入失败
检查文件格式是否与当前版本兼容；只导入可信来源的主题 ZIP 或二维码。
Q: 分体键盘按键变窄 / 各行断点不齐
由 键盘 → 分体、浮动与单手键盘 → 分体键盘 → 强制左右两半在中缝处对齐 开关决定：开启（默认）保证断点对齐但可能压窄按键；关闭则保持每键原宽、断点可能不齐。详见 分体键盘。
反馈
如果你的问题不在以上列表中，请前往 反馈问题 查看如何提交 issue。更完整的逐项排查见 用户指南 §11 故障排查。