Linux 用户须知：如需使用本库配置，推荐使用以下 Rime 安装方式

[mirtlecn]

太长不读 / TR;DL:

不少 Linux 发行版自带软件源 librime（rime 后端引擎）版本或者不够新，或者缺少插件，可以考虑：

• 若使用 fcitx5 + Fedora 等红帽发行版，请考虑使用 Flatpak ¹，其他 Linux 系也可以考虑此方案
  （Update 2024.09.04：Fedora 在 2024 年 09 月左右，添加了 librime-lua 包，你可以自行安装以解决依赖问题）
• 若使用 fcitx5 框架，请保证安装的是 fcitx5-rime 而非 fcitx-rime
• 若使用 fcitx 框架，请改用其继承者 fcitx5
• 若使用 ibus 框架，出现意外，可以考虑使用 Appimage ² ，以跟进 librime 更新。

问题概括

如果你遇到过：Linux （iBus & Fcitx & Fcitx5）无候选 / 部分 Lua 功能异常 / 雾凇拼音候选后出现拼音注释 / 无法使用辅助码 / Error log 中大量 lua 相关错误 / Fcitx5 打字报错 / Lua 脚本无法使用 * 引入 …… 等问题

极有可能说明系统安装的 librime（rime 后端引擎）有问题，例如：

• 自带软件源未安装或者未提供 librime 插件依赖（lua 功能所需）；
• 自带软件源提供的 librime 不够新

本仓库努力保持对各个前端的兼容，但相较 Squirrel、Weasel、Hamster、Fcitx5 Android 等积极维护的前端而言，部分 Linux 软件源更新缓慢，极有可能影响雾凇的使用。

解决方案一：更换 RIME 安装方式

无论何种发行版，RIME 正常工作均续正确安装 librime 及其插件（librime-lua，librime-preedit 等）依赖。请确认系统已经安装这些包（librime-lua 亦可能名为 librime-plugin-lua ³）包。并且 librime 版本 ≥ 1.85（2023.2 发布）。librime-lua 可能以外部模块（如 Debian）或者编译进 librime 的方式（如 Arch）提供，你可以输入 rq （双拼 date），若看到当前日期，则说明 lua 已正确加载。

对于 Debian 系（Ubuntu 等）、Arch 系（Manjaro 等）而言，安装使用包管理器安装 fcitx5-rime 包或者 ibus-rime 包即可。系统会自动处理相关依赖。

对于 Fedora 等少数发行版而言，上游并未提供 librime-lua 包（2024.09.04 已失效），因而可以考虑使用 Appimage 或者 Flatpak 等安装方式：

• ibus：Appimage
• fcitx5：Flatpak

Debian 等发行版提供的 librime 版本老旧，如遇错误，也可以考虑使用上述 Appimage 或者 Flatpak 的安装方式。

其他发行版，如无法自行解决依赖问题，亦可以考虑使用上述 Appimage 或者 Flatpak 的安装方式，或者自行编译 librime。

解决方案二：自行编译 librime

可以考虑参考 librime 的教程，自行编译安装最新 librime。请注意 make 指令默认不编译 librime-lua 等插件，需要安装插件后，执行 make merged-plugins。

附：

Debian 12.5 + Cinnamon（DE）+ Fcitx5 + fcitx5-rime（librime 1.85）

Debian 12.5 + Gnome 43（DE）+ ibus + ibus-rime（librime 1.85）

Footnotes

1. 由 fcitx5 维护团队打包 ↩

2. 由 librime-lua 作者打包 ↩

3. 依发行版不同而不同 ↩

[Mintimate]

上次试了一下在 ARM64 版本的 Kali 上编译 Fcitx5 和 librime，librime是挺好编译的， 但是 Fcitx5 是挺麻烦的。个人觉得，还是用 Flatpak 比较好。

不过，需要注意： Flatpak 安装Fcitx5后，也需要安装Fcitx5 Rime插件。这里给一些之前没用过的小伙伴一下指引：

# flatpak 慢的话，可以使用源：https://mirror.sjtu.edu.cn/docs/flathub
# 安装 Fcitx5
flatpak install flathub org.fcitx.Fcitx5
# 安装 Fcitx5 Rime 插件
flatpak install flathub org.fcitx.Fcitx5.Addon.Rime
# 之后就没什么问题了

同时，使用 flathub 安装的 Fcitx5 ，配置文件在~/.var/app/org.fcitx.Fcitx5/data/fcitx5内。

[AClon314]

补充一点

fedora的需要在宿主装一个IME环境，然后flatpak内的fcitx5就能直通到外部。

sudo dnf install fcitx5 -y # 只是需要一个im服务，所以装ibus或别的都可以
flatpak install org.fcitx.Fcitx5.Addon.Rime # you can install addon if you want

[gaboolic]

没错，之前用linuxmint（ubuntu的衍生版）就遇到过rimelib版本低的问题
在rime的讨论区讨论过 rime/home#1493