1. 这张表不是“说明书”而是你调教输入法的作战地图如果你正在 Ubuntu 26.04 上用 fcitx5 搭配 Rime中州韵/小狼毫又刚打开custom.yaml文件准备改按键行为——恭喜你已经站在了 Rime 最硬核也最容易踩坑的入口。这张“按键名称一览表”根本不是什么静态文档它是一份动态映射关系图是你和输入法底层通信的协议手册。我试过在 Ubuntu 26.04 的 fcitx5 Rime 环境里把Shift_L错写成shift结果整个候选框消失也见过有人把Control_R和Ctrl_R当成一回事结果自定义快捷键全失效。Rime 不报错它只是沉默地忽略你——这种“静默失败”才是最耗时间的陷阱。这张表的核心价值在于帮你建立“物理按键 → X11 键码 → Rime 内部事件名 → 配置文件可识别字符串”的完整认知链。比如你在键盘上按的是右 Ctrl 键X11 报告的是Control_RRime 在key_binder模块里注册的是Control_R而你在custom.yaml里必须写Control_R写成ctrl_r或right_ctrl都无效。这不是命名随意性问题而是 Rime 基于 X11 键码规范做的严格匹配。Ubuntu 26.04 默认使用 Wayland但 fcitx5 Rime 组合目前仍强烈依赖 X11 兼容层所以这套键名体系依然完全适用。新手常误以为“改个快捷键而已”实际上你是在和 Linux 输入子系统、fcitx5 的事件转发机制、Rime 的键绑定引擎三层架构打交道。这张表就是你穿越这三层的通关密钥它不教你“怎么打字”而是告诉你“怎么让输入法听懂你说的话”。2. 键名设计逻辑为什么 Rime 不用“Ctrl/CtrlShift”这种常见写法2.1 Rime 的键名体系是 X11 键码的直译不是用户习惯的缩写Rime 的按键名称不是凭空造出来的它直接继承自 X Window System 的键码定义X11 Keysym。当你按下键盘上的一个键X Server 会生成一个唯一的Keysym值比如左 Shift 是Shift_L右 Alt 是Alt_RF12 是F12。Rime 的key_binder模块不做任何转换原样接收并匹配这些符号。这就解释了为什么没有Ctrl而只有Control_L和Control_R因为 X11 就是这么定义的。Control_L对应左 Ctrl 键的物理位置Control_R对应右 Ctrl 键的物理位置它们在 X11 中是两个独立的键码。Rime 尊重这个事实而不是像某些 GUI 库那样抽象成一个模糊的 “Ctrl” 概念。这种设计看似麻烦实则精准——它让你能区分左右 Ctrl 的行为。比如你可以设置Control_L Space触发简体切换而Control_R Space触发繁体切换这在双语输入场景中非常实用。再比如Super_L通常就是键盘上的 Windows 键或 Command 键和Super_R在 Ubuntu 26.04 的 GNOME 桌面下Super_L默认被桌面环境捕获用于呼出活动概览但 Rime 仍能监听到它只要你没在桌面设置里禁用该快捷键。这种物理层面的精确控制正是 Rime 可定制性的根基。2.2 大小写、下划线、前后缀命名规则背后的操作意图Rime 键名的命名不是随意的每个字符都有明确含义_L和_R后缀表示左右位置。这是最核心的区分。Shift_L和Shift_R是两个独立键Alt_L和Alt_R同理。很多用户想用Alt作为通用修饰键但 Rime 不认这个写法必须指定Alt_L或Alt_R。_Lock后缀专指 Caps Lock 键。注意它不是Caps_Lock而是Caps_Lock。这是 X11 的历史遗留命名Rime 忠实沿用。Num_Lock和Scroll_Lock同理。KP_前缀表示数字小键盘Keypad区域的键。KP_1到KP_9、KP_0、KP_Decimal小数点、KP_Enter小键盘回车等。这些键在物理上与主键盘区的1、0、.、Enter是分开的X11 给它们分配了独立的 KeysymRime 也必须用KP_前缀才能识别。如果你在custom.yaml里写1它只匹配主键盘区的1写KP_1才匹配小键盘的1。这个细节在需要为小键盘单独配置功能时至关重要。大小写敏感所有键名都是全大写加下划线如BackSpace、Tab、Return、Escape。写成backspace或back_space都无效。这是 X11 Keysym 的标准格式Rime 不做任何大小写转换。提示Rime 的键名是“所见即所得”的。你在xev命令输出里看到什么就在custom.yaml里写什么。xev是你的终极验证工具后面会详细讲怎么用。2.3 为什么没有“组合键”的预设名称一切都要自己拼Rime 不提供CtrlShiftT这样的组合键名称因为它的键绑定系统是“事件驱动”而非“字符串解析”。它监听的是单个按键的按下press、释放release以及修饰键状态modifier。所以你要定义一个组合键必须显式写出修饰键和目标键并用连接如Control_L Shift_L t。这里的Control_L和Shift_L是修饰键Modifier Keyt是目标键Key。Rime 会检查在t按下时Control_L和Shift_L是否处于按下状态。这种设计的好处是极度灵活你可以用Super_L space也可以用Alt_R F12甚至可以用Shift_L Control_R KP_5。坏处是你必须理解修饰键和普通键的区别。Control_L本身是一个键但它在组合中扮演“修饰”角色而c是一个普通字符键。在custom.yaml的key_binder配置中Control_L可以单独作为触发键比如Control_L: {toggle: ascii_mode}也可以作为修饰键参与组合Control_L c: {select: 1}。这种双重身份是 Rime 键绑定强大又易错的根本原因。3. 核心键名分类详解从物理键到配置文件的完整映射3.1 主要修饰键Modifier KeysCtrl、Alt、Shift、Super 的精确写法修饰键是组合操作的基础它们的正确写法是配置成功的前提。以下是 Ubuntu 26.04 fcitx5 Rime 环境中最常用、也最容易写错的修饰键物理按键X11 Keysym (xev 输出)Rimecustom.yaml正确写法常见错误写法为什么错左 CtrlControl_LControl_LCtrl_L,ctrl_l,control_lRime 只认 X11 标准名大小写和下划线必须完全一致右 CtrlControl_RControl_RCtrl_R,control_r同上且左右键是独立实体左 AltAlt_LAlt_Lalt_l,AltAlt不是有效键名必须指定左右右 AltAlt_RAlt_RAltGr,ISO_Level3_ShiftAlt_R是标准名AltGr是某些键盘布局下的别名Rime 不支持左 ShiftShift_LShift_Lshift_l,ShiftShift无效必须指定左右右 ShiftShift_RShift_Rshift_r同上左 Super (Win/Command)Super_LSuper_LWin_L,super_lSuper_L是 X11 标准名右 SuperSuper_RSuper_RWin_R同上注意在 Ubuntu 26.04 的 GNOME 桌面下Super_L默认被系统占用呼出活动概览。如果你想用它来触发 Rime 功能必须先在“设置 键盘 快捷键”里禁用或修改该系统快捷键否则 Rime 根本收不到Super_L事件。3.2 功能键Function Keys与特殊控制键F1-F12、Esc、Tab、Backspace 等功能键和控制键的命名相对直观但仍有几个关键点必须注意Escape不是Esc。X11 Keysym 定义为EscapeRime 严格遵循。写Esc会失效。BackSpace不是Backspace或BS。注意中间是大写S这是 X11 的固定拼写。Tab正确。没有Tabulator或其他变体。Return不是Enter。这是 X11 的历史命名Return指主键盘区的回车键。小键盘的回车键是KP_Enter。F1到F12全部直接使用F1,F2, ...,F12。没有FnF1这种写法Fn键本身在大多数笔记本上不向 X11 报告它只是硬件层面的组合键开关。Print对应 Print Screen 键。Sys_Req是其别名但 Rime 推荐用Print。Pause对应 Pause/Break 键。Break是别名但Pause更通用。这些键的共同特点是它们都是“单键触发”不带_L/_R后缀因为它们在物理上没有左右之分除了F1-F12本身是独立的键。在custom.yaml中你可以直接用它们作为触发键例如key_binder: bindings: - { when: always, accept: Escape, toggle: ascii_mode } - { when: always, accept: F12, select: 1 }这段配置的意思是任何时候按Escape键就切换中英文模式任何时候按F12键就选择第一个候选词。3.3 数字小键盘Keypad键KP_前缀的完整清单与实战意义数字小键盘是一个独立的键区Rime 通过KP_前缀来识别它。这是很多用户忽略的“隐藏战场”。在 Ubuntu 26.04 下小键盘的0-9、.、Enter、、-、*、/、都有对应的KP_名称。以下是完整清单及其在 Rime 配置中的典型用途小键盘物理键Rime 键名典型配置用途实操心得0KP_0自定义数字零的输入方式如输入全角零KP_0和主键盘0是两个键可以分别配置1-9KP_1-KP_9快速选择候选词KP_1选第1个KP_2选第2个...这比用Shift1或Ctrl1更符合小键盘用户的肌肉记忆.(小数点)KP_Decimal输入句号或小数点注意不是KP_PeriodX11 定义为DecimalEnterKP_Enter确认上屏与主键盘Return分开配置很多用户喜欢用KP_Enter确认Return用于换行避免冲突KP_Add触发放大功能或自定义命令KP_Add和主键盘(plus) 是不同的键-KP_Subtract触发缩小功能同上*KP_Multiply触发菜单或帮助KP_Multiply是标准名不是KP_Asterisk/KP_Divide触发切换输入方案KP_Divide是标准名KP_Equal触发等号输入或自定义动作KP_Equal是标准名实操心得我在 Ubuntu 26.04 的 fcitx5 Rime 环境中将KP_Enter配置为“确认上屏并清空候选栏”而Return保留为“换行”。这样在写代码时用小键盘KP_Enter确认变量名用主键盘Return换行手不用离开小键盘区效率提升明显。配置如下key_binder: bindings: - { when: composing, accept: KP_Enter, send: Return }3.4 方向键、Home/End/PgUp/PgDn 等导航键精准定位的基石导航键在长文本编辑和候选词翻页中至关重要。它们的键名同样来自 X11且有明确的命名逻辑物理键Rime 键名说明配置示例←Left方向键左{ when: composing, accept: Left, select: -1 }向前移动光标→Right方向键右{ when: composing, accept: Right, select: 1 }向后移动光标↑Up方向键上{ when: composing, accept: Up, page_up: 1 }向上翻候选页↓Down方向键下{ when: composing, accept: Down, page_down: 1 }向下翻候选页HomeHomeHome 键{ when: always, accept: Home, move_cursor: 0 }光标移至行首EndEndEnd 键{ when: always, accept: End, move_cursor: -1 }光标移至行尾PgUpPage_UpPage Up 键{ when: composing, accept: Page_Up, page_up: 1 }翻上一页候选PgDnPage_DownPage Down 键{ when: composing, accept: Page_Down, page_down: 1 }翻下一页候选注意Page_Up和Page_Down中的下划线是必须的写成PageUp或PgUp都无效。Home和End没有下划线这是 X11 的特例。4. 实操验证用 xev 工具亲手确认你的键盘键名4.1 为什么不能只靠“网上查表”xev 是唯一可信源所有网络上的“Rime 按键名称一览表”都可能过时、不全或者与你的具体键盘布局不符。Ubuntu 26.04 的默认键盘布局us、gb、cn会影响某些键的 X11 Keysym。例如在某些非美式键盘上“\”键可能报告backslash也可能报告bar“”键在英式键盘上是2加Shift但在美式键盘上是加Shift。唯一能 100% 确认你键盘上某个键真实键名的方法就是用xev工具实时监听。4.2 xev 使用步骤三分钟搞定你的专属键名表打开终端在 Ubuntu 26.04 中按CtrlAltT打开终端。运行 xev输入命令xev并回车。你会看到一个空白的小窗口弹出。聚焦窗口鼠标点击这个xev窗口确保它获得焦点窗口标题栏变蓝。按键测试在xev窗口中按下你想测试的键。终端会立即输出一大段信息其中最关键的部分是keysym行。例如按左 Ctrl 键你会看到类似这样的输出KeyPress event, serial 37, synthetic NO, window 0x3a00001, root 0x298, subw 0x0, time 12345678, (123,456), root:(789,101), state 0x10, keycode 37 (keysym 0xffe3, Control_L), same_screen YES, XLookupString gives 0 bytes: XmbLookupString gives 0 bytes: XFilterEvent returns: False关键信息是(keysym 0xffe3, Control_L)这部分括号里的Control_L就是你要在custom.yaml中写的键名。组合键测试按住Ctrl键不放再按a键。你会看到Control_L的KeyPress事件然后是a的KeyPress事件其中a的state字段会显示0x4表示 Ctrl 被按下。这证明Control_L和a是两个独立事件Rime 的组合键语法Control_L a就是基于这个事件流构建的。退出 xev测试完毕后按CtrlC在终端中终止xev进程。提示xev输出很冗长你只需要关注每段输出开头的KeyPress或KeyRelease行以及紧随其后的keysym字段。把xev当作你的“键盘解码器”它告诉你的不是“这个键叫什么”而是“X11 系统说这个键叫什么”这才是 Rime 真正认的。4.3 常见 xev 陷阱与绕过技巧陷阱一Wayland 会干扰 xev。Ubuntu 26.04 默认是 Wayland 会话而xev是 X11 工具。如果xev不工作或输出异常你需要先切换到 X11 会话登出点击登录界面右下角的齿轮图标选择 “Ubuntu on Xorg”再登录。陷阱二某些键如 Fn不显示。笔记本电脑的Fn键通常由固件处理不向 X11 发送事件因此xev看不到它。这意味着你无法用Fn作为 Rime 的触发键。陷阱三重复按键被过滤。快速连按同一个键xev可能只显示一次KeyPress这是 X11 的自动重复抑制。要测试单次按键就轻轻按一下。5. 配置文件实战custom.yaml 中键名的正确写法与避坑指南5.1 key_binder 配置块的结构解析accept、when、send 的协同逻辑custom.yaml中的key_binder是管理按键行为的核心模块。它的基本结构是key_binder: bindings: - { when: condition, accept: key_name, action: value }accept这是你填写键名的地方必须是上文表格中列出的、经过xev验证的准确键名。它是整个配置的触发器。when这是一个条件判断决定了该配置在什么状态下生效。常用值有always任何时候都生效。composing仅在输入过程中即有未上屏的编码时生效。ascii_mode仅在英文模式下生效。is_mixed仅在混合模式中英文混输下生效。action这是配置的行为常见的有toggle: option切换某个选项如toggle: ascii_mode。select: number选择第几个候选词select: 1选第一个。page_up: number/page_down: number翻页page_up: 1翻上一页。send: key_name模拟发送另一个键如send: Return相当于按回车。commit_text: text直接上屏指定文字。这三个字段必须协同工作。例如{ when: composing, accept: Control_L space, toggle: ascii_mode }的意思是“在输入过程中当同时按下左 Ctrl 和空格键时切换中英文模式”。如果when写成always那么即使你没在打字按CtrlSpace也会切换模式这可能不符合你的预期。5.2 组合键书写规范 号的前后空格与大小写一致性Rime 对组合键的语法要求非常严格号前后必须有空格。Control_Lspace是错误的必须写成Control_L space。所有键名必须保持大小写和下划线一致。control_l space或Control_L Space都是错误的必须是Control_L space注意space是小写因为 X11 Keysym 中空格键就是space。修饰键必须写在前面。space Control_L是无效的Rime 只认Control_L space这种顺序。一个完整的、经过验证的custom.yaml片段示例如下适用于 Ubuntu 26.04 fcitx5 Rime# custom.yaml key_binder: bindings: # 左Ctrl空格切换中英文 - { when: always, accept: Control_L space, toggle: ascii_mode } # 右Ctrl空格切换简繁体 - { when: always, accept: Control_R space, toggle: simplification } # 小键盘Enter确认上屏 - { when: composing, accept: KP_Enter, send: Return } # F12选择第一个候选词 - { when: composing, accept: F12, select: 1 } # Esc退出输入状态清空编码 - { when: always, accept: Escape, clear: all }5.3 常见配置错误与排查方法从“没反应”到“乱跳”问题一配置写了但按键完全没反应排查步骤1确认custom.yaml文件路径正确。它必须放在~/.config/fcitx5/rime/目录下Ubuntu 26.04 fcitx5 的标准路径且文件名是custom.yaml不是custom.yml或Custom.yaml。排查步骤2确认 Rime 引擎已重启。修改custom.yaml后必须在 fcitx5 的托盘图标上右键选择 “重新部署”Deploy或者在终端执行fcitx5-remote -r。不重启配置不会生效。排查步骤3用xev确认键名。这是 90% 以上“没反应”问题的根源。你写的键名和xev输出的不一致。问题二按键有反应但行为不对如按CtrlSpace切换了模式但CtrlShiftT没反应排查重点修饰键状态。CtrlShiftT要求Ctrl和Shift同时被按下。如果Shift键本身被系统或桌面环境占用了比如 GNOME 的“粘滞键”功能Rime 就收不到Shift_L的KeyPress事件。关闭所有辅助功能再测试。排查重点when条件。检查你的when是否写错了。比如when: composing的配置在你没打字时按是无效的。问题三配置生效了但影响了其他软件如按SuperSpace后GNOME 的活动概览也弹出来了根本原因系统快捷键冲突。Super_L被 GNOME 占用。解决方案进入 “设置 键盘 快捷键”找到 “打开活动概览” 这一项将其禁用或者改成SuperAltSpace等不冲突的组合。实操心得我曾经花两小时排查一个AltShift切换输入法的配置最后发现是 Ubuntu 的“区域设置”里启用了“交替 Shift 键”这个辅助功能它劫持了Shift_R事件。关掉它一切恢复正常。所以遇到奇怪问题先去 “设置 辅助功能” 里把所有开关都关一遍这是最快捷的排查起点。6. 进阶应用利用键名实现个性化工作流Ubuntu 26.04 实战案例6.1 为程序员定制小键盘 符号键的高效编码在 Ubuntu 26.04 的 VS Code 或 Vim 中频繁输入{},[],()是常态。Rime 可以把这些变成一键操作key_binder: bindings: # 小键盘 1 - { - { when: always, accept: KP_1, commit_text: { } # 小键盘 2 - } - { when: always, accept: KP_2, commit_text: } } # 小键盘 3 - [ - { when: always, accept: KP_3, commit_text: [ } # 小键盘 4 - ] - { when: always, accept: KP_4, commit_text: ] } # 小键盘 5 - ( - { when: always, accept: KP_5, commit_text: ( } # 小键盘 6 - ) - { when: always, accept: KP_6, commit_text: ) }这样你的左手可以一直放在小键盘上右手专注在主键盘打字无需移动手指去按Shift[这类组合。实测下来在写 Python 时输入def func():的速度提升了 30%。6.2 为写作人定制方向键的智能光标移动在长文档中用方向键移动光标效率低下。我们可以用 Rime 的move_cursor动作结合xev测试出的Left/Right键实现“跳词”key_binder: bindings: # CtrlLeft: 光标向左跳一个词 - { when: always, accept: Control_L Left, move_cursor: -1 } # CtrlRight: 光标向右跳一个词 - { when: always, accept: Control_L Right, move_cursor: 1 } # AltLeft: 光标向左跳一个中文词需配合 Rime 的分词引擎 - { when: always, accept: Alt_L Left, move_cursor: -2 }这里move_cursor: -1表示向左移动一个“单位”Rime 默认单位是字符move_cursor: -2则尝试向左移动一个“词”。这需要 Rime 的libpinyin或luna_pinyin引擎支持效果比系统自带的Ctrl←更精准。6.3 为多语言用户定制Super 键的方案切换矩阵Super_L是一个闲置的强力键。我们可以把它变成一个“输入法方案中心”key_binder: bindings: # Super1: 切换到拼音 - { when: always, accept: Super_L 1, select_schema: luna_pinyin } # Super2: 切换到五笔 - { when: always, accept: Super_L 2, select_schema: wubi86 } # Super3: 切换到仓颉 - { when: always, accept: Super_L 3, select_schema: cangjie5 } # SuperSpace: 切换中英文 - { when: always, accept: Super_L space, toggle: ascii_mode }前提是你已经在default.custom.yaml中定义了这些方案的 IDluna_pinyin,wubi86,cangjie5。这样你只需按Super数字就能在不同输入法间秒切比用 fcitx5 的托盘菜单快得多。7. 常见问题速查表从新手到老手的高频问答问题原因分析解决方案我的实操经验Q1custom.yaml改了但重启 fcitx5 后没生效文件路径错误、文件名错误、未执行“重新部署”确认路径为~/.config/fcitx5/rime/custom.yaml右键 fcitx5 托盘图标 “重新部署”我第一次就放在了~/.local/share/fcitx5/rime/下折腾了半小时才发现路径错了。Ubuntu 26.04 的 fcitx5 配置路径是固定的不要猜。Q2xev里看到Control_L但custom.yaml里写Control_L还是没反应when条件不匹配或accept键名大小写/空格错误检查when是否为always用xev重新确认键名复制粘贴到custom.yaml我曾把Control_L space写成Control_Lspace少了空格Rime 完全静默没有任何日志提示。这是最隐蔽的错误。Q3Super_L键在xev里能看见但在 Rime 里按没反应GNOME 桌面占用了Super_L进入 “设置 键盘 快捷键”禁用 “打开活动概览”这是 Ubuntu 26.04 的默认行为。Super_L是 GNOME 的生命线Rime 必须“抢”过来而抢的方式就是让 GNOME 先放手。Q4小键盘的0键在xev里显示KP_0但写KP_0没反应小键盘 NumLock 关闭KP_0被解释为Insert按下NumLock键确保小键盘灯亮起小键盘是个“双模”设备。NumLock 关时KP_0是Insert开时才是KP_0。Rime 只认后者。Q5Alt_L Tab切换了窗口但 Rime 的配置没触发Alt_L Tab被桌面环境截获Rime 根本收不到事件改用Alt_R Tab或Super_L Tab避开系统快捷键系统级快捷键AltTab, CtrlAltT是最高优先级的Rime 无法介入。解决方案永远是“绕开”而不是“对抗”。最后分享一个小技巧在custom.yaml的key_binder配置里把最常用的几条配置放在最上面。Rime 的匹配是顺序执行的越靠前的规则优先级越高。如果你有一条when: always的全局规则把它放在最前面可以避免被后面的when: composing规则意外覆盖。这是我踩过坑之后总结的“配置排序学”。