Ubuntu 24→26 升级后 ibus-rime（五笔拼音混输）失效完整修复文档

一、故障现象（升级后典型问题）

Ubuntu 24.04 跨大版本升级至 26.04 后，ibus-rime（東風破Plum配置）出现以下问题：

输入法列表仅剩余地球拼音，五笔、五笔拼音混输方案全部消失
频繁弹窗提示 Rime is under maintenance，持续部署卡住
用户自定义词库、五笔方案文件均存在，但无法加载生效
Ctrl+` 切换方案无可用混输、五笔选项

二、故障根因（Ubuntu26专属）

本次故障不是方案文件丢失，而是大版本升级的兼容性问题：

关键配置文件丢失：升级会清空/重置系统输入法配置，导致 default.custom.yaml 全局补丁配置丢失，Rime 无可用方案加载列表
编译缓存损坏：Ubuntu26 新版 librime 校验规则更严格，旧版本编译缓存不兼容，导致部署卡死、反复维护
ibus 会话残留：大版本升级后输入法后台进程残留，单纯重启服务无法彻底生效

✅ 确认：用户自定义目录 ~/.config/ibus/rime/ 下的五笔码表、混输方案、自定义补丁、词库全部完好，无需重装方案包。

三、前置检查（确认环境完好）

执行命令查看本地Rime文件，确认核心方案存在：

ls ~/.config/ibus/rime | grep wubi

正常输出应包含：wubi86.dict.yaml、wubi_pinyin.schema.yaml、wubi86_pinyin.custom.yaml，代表方案文件完整。

四、分步修复流程（100%生效）

步骤1：重建缺失的全局核心配置

升级后丢失 default.custom.yaml，该文件控制Rime加载哪些输入方案，必须重建：

nano ~/.config/ibus/rime/default.custom.yaml

粘贴以下完整配置（严格2空格缩进，禁止Tab、冒号后必须加空格，适配Ubuntu26新版Rime）：

# 全局自定义配置 - 适配Ubuntu26 ibus-rime
patch:
  # 启用输入方案（五笔拼音混输优先）
  schema_list:
    - schema: wubi_pinyin
    - schema: luna_pinyin_simp

  # 候选词数量
  menu:
    page_size: 9

  # Shift 切换中英文
  ascii_composer:
    switch_key:
      Shift_L: commit_code
      Shift_R: commit_code

  # -= 上下翻页快捷键
  key_binder:
    bindings:
      - { when: has_menu, accept: minus, send: Page_Up }
      - { when: has_menu, accept: equal, send: Page_Down }

保存退出：Ctrl+O → 回车 → Ctrl+X

步骤2：清理损坏缓存，彻底重编译

删除不兼容旧缓存，手动触发完整部署（解决卡死维护问题）：

rm -rf ~/.config/ibus/rime/build
rime_deployer --build ~/.config/ibus/rime

步骤3：重启输入法服务生效

ibus restart
ibus engine rime

步骤4：终极兜底（适配Ubuntu26会话bug）

若仍不生效，注销当前用户重新登录（大版本升级后ibus进程残留专属解决方案）。

五、修复完成验证

输入法切换快捷键 Ctrl+`，可看到 五笔·拼音混输 方案
输入五笔编码（如ggll）、拼音编码（如zhong）均可正常上屏，混输功能恢复
无 Rime is under maintenance 持续弹窗

六、原有功能保留说明

五笔拼音反查：本地 wubi86_pinyin.custom.yaml 配置保留，部署后自动生效，拼音输入可显示五笔编码
自定义词库：userdb、个人词库文件全部保留，无需重新导入
快捷键配置：Shift中英切换、-=翻页等自定义设置完全恢复

七、后续日常维护命令（Ubuntu26专用）

后续修改任何Rime配置，统一使用以下命令生效：

rm -rf ~/.config/ibus/rime/build
rime_deployer --build ~/.config/ibus/rime
ibus restart

八、常见报错排查

部署报错：检查yaml文件缩进（仅2空格）、冒号后空格，无Tab制表符
方案依旧不显示：查看日志 cat ~/.config/ibus/rime/build/installation.log 定位语法错误
输入法无响应：执行 ibus-daemon -drx 重启ibus守护进程

九、预防下次升级失效（备份方案）

定期备份完整Rime配置目录，规避系统升级丢失配置：

cp -r ~/.config/ibus/rime ~/rime-backup-$(date +%Y%m%d)

Dean King
2026/8/21 于唐山

DeanLib