蔡振原很多人第一次接触 Rime，其实不是冲着“折腾”去的，而是想好好打简体中文。结果装上小狼毫、鼠须管或者 fcitx5-rime 之后，第一轮敲拼音时，满屏候选偏偏是繁体，词库拐来拐去，翻页键还和你平时用的习惯不一样。这篇操作指引就是为这种情况准备的：我会把 Rime 配置简体中文输入法的完整链路拆开，从平台安装、框架选型、配置文件的语法逻辑，到默认方案锁定、简繁开关、第三方方案集成，再到常见的“改完不生效”排查方法，全部整理成可以直接照着做的步骤。不管你是刚入坑的新手，还是已经在 Rime 边缘试探但被 YAML 劝退的老玩家，这篇文章都能让你少走不少弯路。
1. 先明白你在折腾什么：Rime 的配置哲学
1.1 “输入法引擎”而不是“输入法”
刚接触 Rime 的人最容易搞混一件事：Windows 上的小狼毫、macOS 上的鼠须管、Linux 里的 ibus-rime 和 fcitx5-rime，看起来是不同的输入法软件，其实它们都只是 Rime 的“外壳”或者说“前端”。真正的核心是一套配置驱动的输入法引擎：你按什么键、候选怎么排列、拼音怎么切分、词库怎么读取，全部由文本文件决定，而不是由某个写死的程序逻辑决定。
这和搜狗、微信输入法那种“装好就用，功能都画在界面上”的思路完全不一样。Rime 更像装修房子：别人给你的是毛坯户型，你想隔出几个房间、刷什么颜色、摆什么家具，都需要自己动手改。好处是只要你能把需求写成配置，它几乎什么都能做；坏处是刚上手时你连“门往哪开”都得自己定，门槛明显高。
所以这篇配置简体中文输入法的操作指引，表面上是教“怎么让 Rime 打出简体字”，实际上是在教你 Rime 的配置方法和思考方式。一旦弄懂了规则，后面改候选词数量、换词库、做快捷键，都是同一套逻辑，一通百通。
1.2 用补丁思维改配置：custom.yaml 才是你的主战场
Rime 的配置文件使用 YAML 格式。初次打开配置目录的人，多半会先被一堆文件吓到：有 .schema.yaml、default.yaml、各种 .dict.yaml，有的还有 .custom.yaml。我的建议是：先忘掉那些原生的 .yaml 文件，你真正需要经常改的是带 custom 名字的文件。
原生的 default.yaml、luna_pinyin.schema.yaml 这些文件，相当于出厂设置。更新输入法时它们可能会被覆盖，而且这些文件经过多次版本迭代后极其复杂，直接改它们既不安全，也不利于将来维护。Rime 的设计者很早就考虑到这个问题，于是引入了 *.custom.yaml 的机制：你写的个性化配置都放在 custom 文件里，里面通过 patch 字段去修改原始文件里的某几个值。部署时 Rime 会把你写的补丁和原始配置做一次“合并”，最终生效的是合并后的结果。
简单来说，default.custom.yaml 就是你的“用户配置页”，原始文件是“系统配置页”。别人更新系统时不会动你的用户配置页，你的改动也不会影响系统升级。这种补丁式思维贯穿整个 Rime 配置过程，理解了它，后面的操作就不会觉得东一榔头西一棒子了。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 三平台安装与框架选型：小狼毫、鼠须管与 fcitx5-rime
2.1 Windows 小狼毫：安装后先别急着改配置
小狼毫（Weasel）是 Windows 平台最常见的 Rime 外壳。从官网下载安装包、一路下一步装完，系统会多出一个“中州韵”输入法。安装完成后先不要急着去改文件，打开一个记事本或浏览器，按 Ctrl + Space 或者用系统托盘切换输入法，先确认一下能不能打出中文。
首次安装后 Rime 会自己做一次“部署”，也就是生成初始配置和输入方案。这一步如果没完成，你会看到托盘里的图标一直转圈，或者怎么敲都是英文。遇到这种情况，最简单的方法是右键托盘图标，找到“重新部署”或“部署”菜单，点一下，等右下角气泡提示部署完成，再测试输入。
小狼毫默认自带的输入方案里有“朙月拼音”，也就是传统拼音输入。很多人此时会发现打出来的候选是繁体字——别急，这是 Rime 的默认状态之一，后面我们会在配置阶段把它固定成简体输出。另外提醒一句，小狼毫的配置目录默认在 %APPDATA%\Rime，也就是 C:\Users\你的用户名\AppData\Roaming\Rime，安装目录是不放配置文件的，很多人找不到配置目录就是被这一步卡住。
2.2 Linux 我推荐 fcitx5-rime，附 Ubuntu/Fedora 命令
Linux 平台稍微复杂一点，因为要选输入法框架。常见的组合是 ibus-rime 和 fcitx5-rime。我的意见很直接：除非你的桌面环境默认绑定 ibus 且你不想动它，否则优先考虑 fcitx5-rime。
原因有三点。第一，fcitx5 现在的维护非常活跃，对 Wayland 会话的支持也比较完善；第二，fcitx5-rime 和桌面面板的集成度高，Rime 的菜单、切换开关、部署操作都能直接在输入法托盘里完成；第三，社区里大量最新的 Rime 配置教程和方案都是基于 fcitx5 环境验证的，你遇到问题更容易搜到前人的解法。
安装命令不复杂。Ubuntu 24.04 这样的系统上，执行：
bash复制sudo apt install fcitx5 fcitx5-rime
Fedora 系列则用：
bash复制sudo dnf install fcitx5 fcitx5-rime
装完之后还要做一步关键操作：把系统输入法框架切换成 fcitx5。在支持环境变量的桌面里，可以编辑 ~/.xprofile 或启动脚本，写入这几行：
bash复制export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
然后注销重新登录。打开 fcitx5 的设置界面，在“输入法”列表里添加“Rime”，此时系统应该就能用 Rime 打中文了。这里我特别提醒一句：ibus 和 fcitx5 不要同时启用，否则两套框架会抢按键事件，表现就是输入法时灵时不灵，或者干脆无法呼出。
2.3 macOS 鼠须管：别在隐藏目录里迷路
macOS 上是鼠须管（Squirrel）。安装方式通常是把 Squirrel.app 拖进应用程序目录，然后在“系统设置 → 通用 → 键盘 → 输入法”里添加“鼠须管”。这一步做完后，系统状态栏应该能看到输入法图标，切换到鼠须管后同样先测试能不能出中文。
鼠须管的配置目录在 ~/Library/Rime。注意 ~/Library 默认在 Finder 里是隐藏的，需要在访达里按快捷键 Cmd + Shift + . 才能显示隐藏文件，或者在“前往 → 前往文件夹”里直接输入 ~/Library/Rime 回车。很多 macOS 用户在第一步就迷路了，不要慌，这个目录第一次可能不存在，可以先用输入法打几个字，触发它自动生成，也可以手动新建。
另外 macOS 的鼠须管在某些系统版本上需要用户在“系统设置 → 隐私与安全性”里允许输入法相关的权限，如果切到鼠须管后什么都打不出来，先检查那里。
3. 配置文件骨架：schema 与 default 到底谁说了算
3.1 配置目录在哪里：一张表看明白
这一步建议大家直接把自己平台的配置目录记下来，因为后面的文件操作都要在这里完成。
| 平台 | 外壳 | 配置目录 |
|---|---|---|
| Windows | 小狼毫 | %APPDATA%\Rime |
| macOS | 鼠须管 | ~/Library/Rime |
| Linux (fcitx5) | fcitx5-rime | ~/.local/share/fcitx5/rime |
| Linux (ibus) | ibus-rime | ~/.config/ibus/rime |
注意，如果你在 Linux 上用的是 fcitx5，但试图去 ~/.config/ibus/rime 里找配置，那肯定找不到。目录和框架选型必须对应上，这也是新手最容易搞混的地方。
3.2 default.yaml 和 .schema.yaml 的分工
配置目录里的文件看上去很多，其实可以按职责分成三大类。
第一类是全局默认配置，代表是 default.yaml。它负责整个 Rime 的“公共设定”，比如候选栏每页显示几个词、翻页键、快捷键、菜单开关等。第二类是具体输入方案，名字通常形如 luna_pinyin.schema.yaml，也就是“朙月拼音”这一套方案的具体定义，包括拼音规则、词库引用、候选排序方式等。第三类是词典与用户数据，比如 .dict.yaml 结尾的码表文件、userdb 结尾的用户词典目录。
这里有个容易误解的概念：Rime 默认带有不止一种输入方案。schema 可以理解成“一个输入法皮肤 + 一套规则集合”，你可以有朙月拼音、仓颉、注音等多个方案。当前启用哪些方案、默认用哪一个，由 default.yaml 里的 schema_list 字段决定。所以“把 Rime 默认变成简体中文”这件事，本质上就是修改“默认启用方案”和“方案的输出状态”两个层面。
3.3 一切个性化都从 patch 开始
前面说过，真正的个性化配置要写在 custom 文件里，写法如下：
yaml复制patch:
schema_list:
- schema: luna_pinyin
比如上面这段，如果放在 default.custom.yaml 里，就表示“把 default.yaml 里的 schema_list 覆盖成只启用 luna_pinyin 一个方案”。看到这里你会发现一个关键点：patch 后面不是完整复制原始配置，而是只写你想覆盖的那部分，Rime 会做层级合并。
写 custom 文件时有几个细节要想清楚。
第一，文件名必须严格对应。你要改全局配置，就写 default.custom.yaml；要给某个方案做个性化，就写 luna_pinyin.custom.yaml，不能乱起名。第二，YAML 对缩进敏感，冒号后面要有空格，列表项用短横线缩进对齐，任何一处马虎都可能导致配置直接不生效。第三，保存文件时尽量用 UTF-8 无 BOM 编码。Windows 记事本默认存的 UTF-8 带 BOM，个别情况下会让 Rime 解析出错，所以我一般建议用 VS Code 或 Notepad++ 编辑。
4. 把简体中文变成默认：一次完整的实操
4.1 第一步：改 default.custom.yaml 锁定默认方案
现在的目标很明确：让 Rime 启动后第一选择就是简体拼音输入，不要我每次手动切换。这个操作可以通过修改 default.custom.yaml 里的 schema_list 完成。
先打开配置目录，找到 default.custom.yaml。如果没有，就新建一个。写入如下内容：
yaml复制patch:
schema_list:
- schema: luna_pinyin
luna_pinyin 是朙月拼音的方案 id，它的作用是告诉 Rime：我只需要这一个方案。之后部署，Rime 的默认输入就是朙月拼音了。当然，如果你之后安装了雾凇拼音这样的第三方方案，也可以把这里的 id 换成那个方案的名字。
这里我想提醒一句：schema_list 里方案的顺序，就是你在输入法菜单里看到的顺序，排在最前面的就是默认方案。想临时切换其他方案时，可以用默认快捷键呼出方案选择菜单（常见是 Ctrl + 反引号 或输入法面板上的菜单按钮）。但很多人真正想要的不是“能切换”，而是“永远不用切”，所以固定 schema_list 是最釜底抽薪的办法。
4.2 第二步：把简繁输出开关状态固定好
锁定默认方案后，还有一个问题需要解决：为什么朙月拼音默认会出繁体？
其实 Rime 的很多方案里，“简出”或“繁出”是一个可切换的开关。初始状态可能并不是你想要的简体输出。这个开关的名字因方案而异，在朙月拼音中常见的是 simplification 或类似含义的 switch。我们可以在 default.custom.yaml 里，通过全局的 switches 覆盖来固定它的初始状态。
yaml复制patch:
schema_list:
- schema: luna_pinyin
switches:
- name: ascii_mode
reset: 0
- name: full_shape
reset: 0
- name: simplification
reset: 1
reset 字段表示每次启动 Rime 时，这个开关默认停在什么状态。ascii_mode 是英文模式开关，reset 为 0 表示默认中文输入；full_shape 是全角模式，reset 为 0 表示默认半角；simplification 是简体输出开关，reset 为 1 表示默认输出简体。这个写法如果在你当前的方案里没有对应开关，Rime 也不会报错，它会忽略不认识的字段，所以相对安全。
需要注意，不同方案的实际 switch 名称可能不同。如果你启用了雾凇拼音或者其他第三方方案，建议打开对应的 .schema.yaml 文件，搜索 switches 字段，按里面写的真实名字来调整。这也是配置 Rime 时比较难受、但必须习惯的一点：方案不同，字段名可能就不同。
4.3 第三步：候选数、翻页键这些小手感
简体中文输出搞定之后，很多人还会顺手调整候选词数量。Rime 默认一页 5 个候选，如果你想一页 9 个，可以在 default.custom.yaml 里这样写：
yaml复制patch:
"menu/page_size": 9
注意这里的写法：带引号的 menu/page_size，表示 YAML 里的层级路径。因为斜杠会被 YAML 解析成特殊字符，所以需要加双引号。这是一个很典型的 Rime 补丁写法，后面改很多东西都是这个套路。
翻页键也值得说一下。Rime 默认的翻页键在不同方案里不一定相同，有人习惯用 - 和 =，有人习惯用 [ 和 ]。如果你想自己定义，可以在 default.custom.yaml 里覆盖 key_bindings 相关配置。不过这个配置项比较复杂，我更推荐先不要动翻页键，多花点时间适应默认键位，实在不习惯再改。我在实际使用中发现，Rime 的默认键位设计是有讲究的，贸然改一堆按键反而会让候选菜单和快捷键产生冲突。
4.4 第四步：重新部署，然后验证结果
改完任何配置文件，都必须要“重新部署”才会生效。部署的动作在不同平台叫法不同：
- Windows 小狼毫：右键托盘图标，菜单里点“重新部署”
- macOS 鼠须管：点击状态栏输入法图标，菜单里选“部署”（Deploy）
- Linux fcitx5-rime：在 fcitx5 托盘右击“重新部署 Rime”，或者重启 fcitx5 进程
部署过程中 Rime 会重新读取所有配置和词库。这一步可能会花费几秒到十几秒，取决于词库大小。部署完成后，测试一下：直接输入拼音，看候选是不是简体；再重启一次系统或注销登录，确认开关默认状态也被固定了。如果都正常，说明这一步已经完成。
5. 嫌麻烦就直接上雾凇拼音：集成步骤与避坑
5.1 为什么雾凇拼音在社区评价这么高
官方自带朙月拼音虽然能用，但很多人的体验是“词库太旧”“候选顺序不符合现代网络用语习惯”“打长句要不断选字”。这时候社区方案就显得很香了。近几年 Rime 社区里口碑最高、搜索引擎里热度也最高的，就是雾凇拼音。
雾凇拼音本质是一套完整的第三方 Rime 配置方案，预置了精心维护的现代汉语词库、常用人名地名、网络词语、英文混输、Emoji 输入等能力。它默认输出简体，候选排序经过大量调教，安装后几乎不需要再做太多二次配置，对“我就想好好打字”的人来说是很省心的选择。很多发行版论坛里的“fedora fcitx5 rime 雾凇拼音”配置帖，本质上都是教怎么把这套方案和 fcitx5-rime 组合起来。
选官方方案还是社区方案，没有绝对对错。如果你喜欢从零开始折腾，理解 Rime 的原理，朙月拼音是好教材；如果你想用最少的配置时间换最好的输入体验，雾凇拼音是更明智的起跑线。
5.2 把雾凇拼音装进 Rime：三步走
这套方案虽然功能多，但安装方式不复杂，前提是别整出路径错误。
第一步，从项目发布页下载雾凇拼音的配置压缩包，或者用 git clone 把仓库拉下来。仓库里通常会有一整个配置目录，里面包含各种 yaml 文件、dict 文件等。
第二步，把下载下来的文件复制到 Rime 配置目录里。我有一个建议：不要直接把整个仓库内容一股脑复制进去，很容易和已有的配置混在一起。更好的做法是先把原目录备份，然后在配置目录里新建一个子目录，或者严格按项目说明把必要文件复制进去。复制时遇到同名文件，要注意覆盖的顺序，尽量保留项目自带版本，否则继续用你本地旧版可能起不到效果。
第三步，改 default.custom.yaml，把默认方案 id 换成雾凇拼音的方案 id。具体是哪个 id，以你下载包内的 .schema.yaml 文件名称为准，常见的是 rime_ice 之类。如果拿不准，最稳妥的做法是先用 Ctrl + 反引号 呼出方案菜单，看雾凇拼音在列表里显示的名字和格式，然后回填到 schema_list 里。
改完之后重新部署。如果部署后候选栏里没有雾凇拼音，大概率是文件没放对目录，或者方案 id 写错了。
5.3 集成后的本地化微调与词库长期维护
雾凇拼音集成完成后，仍然可以用前面学的 custom.yaml 补丁思维继续微调。比如你觉得候选词还是偏多或偏少，就写：
yaml复制patch:
"menu/page_size": 7
如果某个开关导致你打出来的字不符合预期，就去雾凇拼音的 schema 文件里查真正的开关名，再通过 custom 文件覆盖 reset 值。
词库的长期维护是一个容易被忽略的点。Rime 的用户词典以 *.userdb 形式存在，里面记录了你输入过程中积累的词频、用户自造词、删词记录等。每次升级或者覆盖配置前，一定要先把 userdb 目录备份出来。否则你辛辛苦苦养了一两个月的词频，可能被一次更新清得干干净净。用 git 管理的用户，也可以把整个 Rime 配置目录放进仓库，更新词库前先 git diff 看一下可能被覆盖的文件，心里更有底。
6. 改完不生效？这套排查顺序能救你一命
6.1 目录和文件名错误：最隐蔽的头号杀手
我见过太多“改完配置没反应”的案例，最终原因都出在目录或者文件名上。
Windows 用户最容易把配置写到小狼毫的安装目录，实际上配置目录是 %APPDATA%\Rime。Linux 用户最容易混淆 ~/.config/ibus/rime 和 ~/.local/share/fcitx5/rime，明明装的是 fcitx5-rime，却跑到 ibus 的目录里创建文件，当然不会生效。macOS 用户则最容易误以为 ~/Library/Rime 不存在所以不创建，实际上你不知道这个目录存在不代表它不重要。
还有一个坑是 custom 文件名写错。比如 default.custom.yaml 被存成了 default.yaml.custom 或者 default_custom.yaml，Rime 根本不会读取它。这类错误通常在部署时不会报红字，但你就是看不到任何变化。排查方法很简单：打开配置目录，逐字核对文件名和后缀。
6.2 打出来是英文或繁体：开关 reset 的锅
如果你部署后打出来的是英文字母，多半是 ascii_mode 这个开关的 reset 值被设成了 1。中文状态才是 0，英文状态是 1。还有可能是你之前手动按过中英切换键，Rime 把当前状态记在了用户配置里，重部署也没用。这时候打开 Rime 的菜单，把“英文模式”一类的开关手动关掉，再确认 custom 文件里 reset 值写对。
打出来是繁体，问题就出在简繁输出开关上。前面写的 simplification 只是一个通用示意，很多方案里真正的开关名带“繁体”“简体”等字样。我的排查方法是：用文本编辑器打开当前正在使用的 .schema.yaml，搜 switches，把里面 name 字段逐个看一遍，找到负责简繁的那个名字，然后再去 custom 文件里给正确的 name 设 reset。这一步花不了几分钟，但能避免你对着错误字段反复试错。
6.3 权限、编码与最小化测试
Linux 和 macOS 上，配置目录的权限问题也可能让 Rime 无法正常读写用户词库。不要用 root 去运行输入法，也不要手贱把配置目录整个 chmod 777。如果你是普通用户，配置目录归属正确，理论上不需要额外赋权。如果 Rime 启动后连候选都不出，先看目录属主是不是你自己，再考虑用 chown 修正。
编码问题相对隐蔽。Rime 配置文件要求 UTF-8 编码。如果你用 Windows 记事本编辑过 custom 文件，保存时可能带 BOM 头，个别方案解析时会读出一个不可见字符，导致字段名对不上。遇到诡异的不生效，可以用 VS Code 重新打开文件，看右下角编码是不是 UTF-8，再另存为一次。
如果实在无法定位问题，我有一个屡试不爽的“最小化测试法”：先备份当前配置，然后把 custom 文件里所有内容删掉，只保留一行最简单的 patch 配置，比如只改 page_size。部署，看这个改动是否生效。如果不生效，说明配置读写链路有基础问题，应该从目录、文件名、权限入手；如果生效，再逐步把你需要的配置一行行加回去，直到发现是哪一行的语法或字段出了问题。这个办法很土，但排查效率极高。
6.4 我的排查顺序清单
最后把经验浓缩成一份清单，你可以直接保存下来：
- 输入法进程是否在运行，托盘图标是否正常。
- 配置文件是否在正确的配置目录，文件名是否严格对应。
- 文件编码是否为 UTF-8 无 BOM。
- 部署时有没有气泡提示，有没有错误菜单。
- 打开原版
.schema.yaml，确认你改的字段名真的存在。 - 用最小化 patch 测试，确认配置链路本身没问题。
- 确认之后立刻备份 userdb 和 entire 配置目录。
这套顺序我用了很久，基本能覆盖 90% 的“配置后不生效”问题。
7. 配好简体中文后，我会长期坚持的几个习惯
配置这个东西，最怕的不是当时不会，而是过两个月回头一看自己都忘了当时改了什么。所以我的习惯是：每改一次配置，都会在 custom 文件顶部用注释写明改动目的，然后定期把整个 Rime 配置目录做一次压缩备份。如果你用 git，把配置目录放进仓库是最好的版本管理方案。词库更新、配置文件大改之前，先看 diff 再动手，能少受很多气。
我自己现在的主力环境是 Ubuntu + fcitx5-rime + 雾凇拼音，Windows 那边也保留了一份小狼毫配置作为备用。两边用的是同一套 custom.yaml 思想，只是目录不同、部署入口不同。每次跨平台配置时，我都会提醒自己：先看目录，再谈文件；先做备份，再动配置。这两个习惯帮我避免过很多次“辛辛苦苦调好的词频一夜间清零”的惨剧。
最后再分享一个小技巧：Rime 的“部署”功能其实是检查配置是否犯错的最好时机。部署时如果出现红色提示或异常气泡，千万别无视。它可能只是告诉你某个文件缺字段，也可能是整个配置无法解析的前兆。养成“每次部署后扫一眼提示”的习惯，会比你等到打字打不了再回头排查轻松得多。