配置置顶

如何配置自己的 Rime 输入法：从方案启用到可维护的自定义

Rime 配置专题 · 从零配置 · 中文码圈

从用户文件夹、custom YAML、方案清单、方案级补丁、重新部署到备份，建立一套可升级、可迁移的 Rime 配置流程。

先分清发行版文件与自己的配置文件

Rime 的可维护配置应放在用户目录中，用 .custom.yaml 文件对发行版方案做补丁；不要直接修改随输入法安装的 YAML。前者能在升级时继续保留，后者很容易被覆盖。Windows 常见用户目录是 %APPDATA%\Rime；其他系统请从正在使用的前端菜单或官方说明确认实际位置。

从 default.custom.yaml 开始：只启用你真正要用的方案

先在用户目录新建 default.custom.yaml，用 `patch:` 表示覆盖项。方案标识必须与已安装的 schema ID 一致；修改方案列表时通常是整体替换，因此应把希望保留的方案都写全。一个最小示例：

patch:
  schema_list:
    - schema: luna_pinyin_simp
    - schema: double_pinyin_flypy
  menu/page_size: 9

需要改某个方案时，使用方案级补丁

当设置只属于一个方案时，建立 方案ID.custom.yaml，例如 `double_pinyin_flypy.custom.yaml`。先查看对应 schema 文件的项目路径，再用 `patch:` 覆盖一项明确的设置；每次只改一个目标，并把修改原因写在 YAML 注释中。这样出现候选、键位或词库异常时，才知道该从哪一项回退。

保存以后必须重新部署，再用测试词验证

保存 YAML 后，在前端菜单执行“重新部署”或同义操作，让 Rime 编译用户配置和方案文件。部署成功不代表输入行为一定正确：请分别测试零声母音节、双拼特殊键、常用词、英文切换和候选翻页；若配置没生效，先检查文件名、缩进、schema ID 和 YAML 语法。

建立一份可迁移的最小备份

必须保留default.custom.yaml、各方案的 .custom.yaml、自己安装的方案和码表。

词典与同步数据按所用前端的说明备份用户词典与同步数据，迁移前先完成一次同步或导出。

测试清单保留 20 个代表性词和几组双拼音节；换电脑、升级前后都用同一清单核对。

不要直接编辑不要把 build 目录中的编译产物当作配置源，它会在重新部署时重建。

排错顺序：从文件名到最小改动

先把最近改动缩小到一个补丁文件，确认文件名是 `default.custom.yaml` 或正确的 `方案ID.custom.yaml`；再看 YAML 缩进和 schema ID，重新部署后用测试词复测。遇到问题不要立刻复制整套“大神配置”，因为它可能依赖额外方案、词典或旧版本规则。

这篇指南强调可维护性，不替代某个前端或具体方案的 README。配置前先备份用户目录；启用双拼时，也可用本站练习器核对键位和特殊音节，再写入目标方案。