Ubuntu 安装 Fcitx5 中州韵 Rime
内容提要
本文介绍 Ubuntu 下 Fcitx5 与 Rime 中州韵的安装与优化，区分 Rime 用户目录与 Fcitx5 全局配置目录，提供一键脚本和手动安装两种方式，并重点调优五笔拼音：锁定方案、修正标点映射、绑定快捷选词、挂载自定义短语与符号表，设置终端和 IDE 默认英文、状态共享及单 Rime 键盘模式，最后给出备份与重载命令。
延伸解读
配置前必知：两个目录各司其职
文章强调，Rime 用户数据目录（~/.local/share/fcitx5/rime/）存放输入法算法核心的补丁、自定义词库和符号表，由 librime 解析；而 Fcitx5 全局配置目录（~/.config/fcitx5/）存放外壳框架的按键、聚焦行为、状态共享策略等。两者职责严格解耦，应用的默认英文、窗口间状态记忆属于 Fcitx5 层面，码表、字词排序、标点映射属于 Rime 层面。混淆二者会导致配置无效。
标点映射的常见陷阱
在调优五笔拼音时，文章特别提醒：标点映射必须完整保留默认符号，并使用列表形式声明“/”键，例如 "/": ["/", "／", "÷"]。若直接写成标量 "/": "/"，按下 / 会被标点处理器强行直接上屏，导致后续所有 /fh 等特殊符号快捷输入彻底失效。这是配置过程中容易忽略但影响很大的细节。
终端与 IDE 默认英文的配置位置
文章指出，在 Linux 平台下，应用黑白名单必须配置在前端定制文件 fcitx5.custom.yaml 中，在 wubi_pinyin.custom.yaml 中声明 app_options 属于无效配置。通过应用的 WM_CLASS 识别名进行匹配，例如为 Ghostty、VS Code、Claude 等设置 ascii_mode: true，这样进入这些窗口时会默认处于西文模式，避免误输入中文。
备份与同步的注意事项
文章建议建立分层备份目录 rime_backup/，分别存放 Rime 用户目录配置和 Fcitx5 全局环境目录。同时明确严禁跨设备复制 build/、installation.yaml 和 user.yaml：build/ 是本地编译生成的二进制文件，换机时必须重新编译；installation.yaml 记录本机独立 UUID；user.yaml 是本地会话运行时数据。遵循这些规范可避免同步后出现异常。
Q&A
Ubuntu 下 Fcitx5 和 Rime 的配置目录有什么区别？
Rime 用户数据目录是 ~/.local/share/fcitx5/rime/，存放输入法算法核心的补丁（*.custom.yaml）、自定义词库和符号表，由 librime 解析并编译生成二进制码表到 build/ 目录。Fcitx5 全局配置目录是 ~/.config/fcitx5/，存放外壳框架本身的设置，如 config（按键、聚焦行为、状态共享策略）和 profile（输入法列表与分组）。两者职责严格解耦：应用的默认英文、窗口间的状态记忆属于 Fcitx5 层面；码表、字词排序、标点映射属于 Rime 层面。
如何一键安装 Fcitx5 和 Rime 中州韵？
项目维护了自动化部署套件 rime_install/，在新安装的 Ubuntu 系统中，克隆或下载后直接在终端执行：bash rime_install/install.sh。脚本会自动完成：调用 apt 安装 fcitx5、fcitx5-rime、rime-data-wubi 与 rime-data-pinyin-simp；将调优的 rime/ 核心配置部署至 ~/.local/share/fcitx5/rime/；将预设的 fcitx5/ 环境配置部署至 ~/.config/fcitx5/；调用 rime_deployer 完成离线静态构建，并通知 Fcitx5 热重载生效。
如何锁定 Rime 只使用五笔拼音方案？
编辑 ~/.local/share/fcitx5/rime/default.custom.yaml，添加以下内容：patch: schema_list: - {schema: wubi_pinyin}。这样即可锁定仅启用 wubi_pinyin，避免误触其它方案。
如何让终端和 IDE 默认进入英文模式？
在 Linux 平台下，应用黑白名单必须配置在前端定制文件 fcitx5.custom.yaml 中（在 wubi_pinyin.custom.yaml 中声明 app_options 无效）。编辑 ~/.local/share/fcitx5/rime/fcitx5.custom.yaml，通过应用的 WM_CLASS 识别名进行匹配，例如：patch: "app_options/com.mitchellh.ghostty": ascii_mode: true "app_options/code": ascii_mode: true 等。
如何配置 Fcitx5 实现状态共享和防止焦点重置？
编辑 ~/.config/fcitx5/config，在 [Behavior] 部分设置：ShareInputState=Program（同程序共享输入状态），resetStateWhenFocusIn=False（重新聚焦时重置状态设为 False，避免从终端切到浏览器再切回时输入状态被强制重置）。
如何自定义 Rime 的特殊符号表？
在 ~/.local/share/fcitx5/rime/mysymbols.yaml 中配置符号表集合，并在 wubi_pinyin.custom.yaml 中指定识别模式：punctuator/import_preset: mysymbols recognizer/patterns/punct: "^/([0-9]0?|[A-Za-z]*)$"。在中文输入状态下键入 / 加对应缩写即可弹出符号选单，例如 /fh 杂项与电脑标识，/dn 键盘功能键与媒体等。
如何备份 Rime 和 Fcitx5 配置？哪些文件不能跨设备复制？
建立分层备份目录 rime_backup/，包含 rime/（Rime 用户目录配置）和 fcitx5/（Fcitx5 全局环境目录）。严禁跨设备复制的文件：build/（本地编译生成的二进制文件，换机时必须重新编译）、installation.yaml（记录本机独立 UUID）、user.yaml（本地会话运行时数据）。
修改配置后如何重载 Fcitx5 和 Rime？
触发静态编译：rime_deployer --build ~/.local/share/fcitx5/rime /usr/share/rime-data ~/.local/share/fcitx5/rime/build。重载 Fcitx5 守护进程：fcitx5-remote -r。查询当前输入法内部名称：fcitx5-remote -n。切换中英文：直接按下 Shift 键即可。
