NixOS 输入法完整配置指南IBus、Fcitx5、Nabi、Uim、Hime 与 Kime 的声明式部署【免费下载链接】nixpkgsNix Packages collection NixOS项目地址: https://gitcode.com/GitHub_Trending/ni/nixpkgs输入法Input Method是操作系统的核心组件之一负责将键盘敲击、鼠标动作等输入事件转换成用户需要的字符是中文、日文、韩文等表音符号多于键盘按键的语言环境中不可或缺的一环。本文以 NixOS 官方手册中i18n.inputMethod模块为骨架结合 nixpkgs 仓库中 输入法子模块源码 与集成测试用例系统讲解在 NixOS 上声明式配置 IBus、Fcitx5、Nabi、Uim、Hime、Kime 六种输入法框架的方法、可选引擎/插件清单、底层环境变量原理及常见故障排查思路。读完本文你将能在configuration.nix中一次配置、nixos-rebuild后开箱即用地获得完整的多语言输入能力。输入法在 NixOS 中的工作机制输入法解决的核心问题很简单键盘上只有有限的按键而许多语言如 CJK 语言的字素数量远超按键数。输入法框架通过接收键盘事件、查询输入引擎、呈现候选词、提交文本这一系列流程来完成按键 → 字符的转换。在 NixOS 中整个输入法体系由 default.nix 这个顶层模块统一编排。它定义了统一的门面选项i18n.inputMethod并用allowedTypes lib.types.enum [ ibus fcitx5 nabi uim hime kime ]约束可选值每个具体框架再通过各自的子模块如 ibus.nix、fcitx5.nix挂载实现。这种统一入口 按框架分发的设计让你只需改变一个type字段即可整体切换输入法体系。从 default.nix 的源码可以看到模块启用后还会自动构建 GTK2/GTK3 的 immodule 缓存gtk-query-immodules-2.0/gtk-query-immodules-3.0并默认开启 GTK3 支持enableGtk3默认true保证输入法在 GTK 应用中的可用性。核心选项速览选项类型默认值说明i18n.inputMethod.enableboolenabled ! null时为true启用输入法子系统的总开关i18n.inputMethod.typeenumnull或旧enabled的值选择具体框架ibus/fcitx5/nabi/uim/hime/kimei18n.inputMethod.enabledenum/nullnull已废弃请改用typeenable truei18n.inputMethod.packagepath/nullnull内部选项由各子模块自动设置为对应框架的包i18n.inputMethod.enableGtk2boolfalse是否启用 GTK2 支持i18n.inputMethod.enableGtk3booltrue是否启用 GTK3 支持兼容性提示源码中通过lib.mkRenamedOptionModule/lib.mkRemovedOptionModule处理了历史选项迁移。若使用已废弃的i18n.inputMethod.enabled模块会输出警告i18n.inputMethod.enabledwill be removed in a future release. Please use.type, and.enable trueinstead见 default.nix。建议新配置一律使用type字段。IBus智能输入总线IBusIntelligent Input Bus提供功能完整、用户友好的输入法界面是 GNOME 等桌面环境的默认输入法框架之一。基础配置{ i18n.inputMethod { enable true; type ibus; ibus.engines with pkgs.ibus-engines; [ anthy hangul mozc ]; }; }其中i18n.inputMethod.ibus.engines为可选列表用于追加额外的输入引擎。可用 IBus 引擎ibus-engines属性集在源码中以lib.filterAttrs (lib.const lib.isDerivation) pkgs.ibus-engines的方式动态枚举见 ibus.nix当前文档明确收录的引擎如下引擎pkgs.ibus-engines.语言/类型说明anthy日语将平假名文本转换为假名汉字混排文本hangul韩语韩文输入引擎libpinyin中文拼音输入引擎m17n多语言使用 m17n 数据库中的输入法与对应图标mozc日语Google 出品的日语输入法table表格类加载输入法表格的通用引擎table-others表格类各类表格输入法合集必须与table同时出现在列表中表格类引擎有特殊要求使用table-others及其他基于表格的引擎时必须让table也出现在引擎列表中例如{ ibus.engines with pkgs.ibus-engines; [ table table-others ]; }引擎注册的底层逻辑从 ibus.nix 源码可见引擎列表通过pkgs.ibus-with-plugins.override { plugins cfg.engines; }打包进 IBus 运行环境且每个引擎包必须带有meta.isIbusEngine true标记才会被类型检查接受。启用 IBus 后模块还会自动生成/etc/xdg/autostart/ibus-daemon.desktop以ibus-daemon --daemonize --xim方式自启守护进程强制启用programs.dconfWithout dconf enabled it is impossible to use IBus并把 IBus 包注册进 dbus 服务设置XMODIFIERSimibus并在非 Wayland 前端模式下设置GTK_IM_MODULEibus、QT_IM_MODULEibus见 ibus.nix。值得注意的是即使配置了引擎包还需要在nixos-rebuild之后打开 IBus 的偏好设置对话框手动把引擎添加到激活列表输入法才会真正生效。IBus 故障排查glib 版本不一致手册提供了官方故障排查法如果 IBus 在部分应用中正常工作、在其他应用中失效很可能是因为 IBus 与应用链接了不同版本的glib。可用如下命令检查nix-store -q --requisites path | grep glib其中path是 IBus 或某个应用的 Nix store 路径。两侧输出的glib包路径必须完全一致若不一致重新安装卸载后重装对应应用是常见解法。Fcitx5下一代输入法框架Fcitx5 是支持插件扩展的输入法框架内置拼音Pinyin、区位QuWei和表格类三种输入引擎并可通过i18n.inputMethod.fcitx5.addons追加更多引擎、字典、皮肤等插件。基础配置{ i18n.inputMethod { enable true; type fcitx5; fcitx5.addons with pkgs; [ fcitx5-mozc fcitx5-hangul fcitx5-m17n ]; }; }i18n.inputMethod.fcitx5.addons可选用于添加 Fcitx5 附加组件。可用 Fcitx5 附加组件插件pkgs.语言/类型说明fcitx5-anthy日语将平假名转换为假名汉字混排文本fcitx5-array中文行列输入法基于 30 键网格fcitx5-chewing繁体中文智能注音输入法繁体中文 Unix 用户常用fcitx5-hangul韩语韩文输入引擎fcitx5-unikey越南语越南语输入引擎fcitx5-m17n多语言基于 m17n 数据库的输入法fcitx5-mozc日语Google 出品的日语输入法fcitx5-table-other表格类各类表格输入法合集fcitx5-chinese-addons中文各种中文输入法合集fcitx5-rime中文RIME 引擎支持中州韵插件之外的深度配置选项从 fcitx5.nix 源码可以看到除了addonsFcitx5 子模块还提供了一系列高级选项可完全声明式地接管 Fcitx5 的运行配置fcitx5.waylandFrontendbool默认false使用 Wayland 输入法前端开启后不再设置GTK_IM_MODULE与QT_IM_MODULE环境变量fcitx5.quickPhraseattrsOf str内联定义快捷短语quick phrase模块会将其序列化生成share/fcitx5/data/QuickPhrase.mbfcitx5.quickPhrase { smile ・∀・; angry (ー); };fcitx5.quickPhraseFilesattrsOf path从本地.mb文件引入快捷短语表写入share/fcitx5/data/quickphrase.d/name.mbfcitx5.settings.globalOptions以 INI 格式写入config文件的全局选项fcitx5.settings.inputMethod以 INI 格式写入profile文件的输入法列表与分组fcitx5.settings.addons以 INI 格式写入conf/目录中对应插件的配置含 global section例如{ pinyin.globalSection.EmojiEnabled True; }fcitx5.ignoreUserConfigbool默认false完全忽略用户配置文件——启用后用户词典将无法保存与加载需谨慎使用模块会设置SKIP_FCITX_USER_PATH1。这些设置最终通过environment.etc.xdg/fcitx5/...落到系统级/etc/xdg/fcitx5/目录。写法上settings的键名即对应 Fcitx5 原生配置的 section 名与键名与图形界面fcitx5-configtool的产物完全同构。官方集成测试一整套输入法验证仓库在 nixos/tests/fcitx5/default.nix 中提供了完整的 NixOS 集成测试既是该配置正确性的实证也是理解配置语义的绝佳参考。测试节点同时挂载了fcitx5-chinese-addons、fcitx5-hangul、fcitx5-m17n、fcitx5-mozc四个插件并通过fcitx5.settings声明了完整的热键与输入法分组fcitx5.settings { globalOptions { Hotkey.EnumerateSkipFirst false; Hotkey/TriggerKeys.0 Controlspace; Hotkey/EnumerateForwardKeys.0 AltShift_L; Hotkey/EnumerateBackwardKeys.0 AltShift_R; }; inputMethod { GroupOrder.0 NixOS_test; Groups/0 { Default Layout us; DefaultIM wbx; Name NixOS_test; }; Groups/0/Items/0.Name keyboard-us; Groups/0/Items/1 { Layout us; Name wbx; }; Groups/0/Items/2 { Layout us; Name hangul; }; Groups/0/Items/3 { Layout us; Name m17n_sa_harvard-kyoto; }; Groups/0/Items/4 { Layout us; Name mozc; }; }; };测试脚本在 X 会话中依次模拟五笔gggh→ 一 下、韩文gks→ 한、梵文天城体ka→ क、日文ka→ か输入并通过 Unicode 输入模式输入 ☺最终断言终端输出为☺一下한कか\n。这组用例直观展示了addons决定可用引擎、settings.inputMethod决定引擎分组与切换顺序、settings.globalOptions决定触发热键——三者配合即可完全脱离图形工具完成 Fcitx5 的声明式调校。版本迁移备注fcitx5.nix 中移除了旧选项enableRimeDataRIME 数据现内置于fcitx5-rime可用fcitx5-rime.override { rimeDataPkgs ...; }定制与plasma6Supportfcitx5-configtool 现仅使用 Qt6。Nabi基于 XIM 的韩文输入法Nabi 是一款易于使用的韩文 X 输入法支持输入表音韩文字符hangul与表意韩文字符hanja。配置非常简洁{ i18n.inputMethod { enable true; type nabi; }; }从 nabi.nix 源码可见启用 Nabi 后模块会设置GTK_IM_MODULEnabi、QT_IM_MODULEnabi、XMODIFIERSimnabi三组环境变量并通过services.xserver.displayManager.sessionCommands在登录会话中启动nabi守护进程。顶层模块文档同时提醒Nabi 不支持 Qt 5 应用存在 Qt 程序输入需求时应考虑其他框架。Uim通用输入法框架Uimuniversal input method是一个多语言输入法框架应用通过所谓的 bridge桥接层使用它主要支持中文、日文与韩文{ i18n.inputMethod { enable true; type uim; }; }Uim 的独特之处在于可切换工具栏。i18n.inputMethod.uim.toolbar选项的可选值为gtk、gtk3、gtk-systray、gtk3-systray、qt5默认gtk见 uim.nix。例如选择系统托盘工具栏{ i18n.inputMethod { enable true; type uim; uim.toolbar gtk-systray; }; }模块启用后同样注入GTK_IM_MODULEuim、QT_IM_MODULEuim、XMODIFIERSimuim环境变量并在会话启动时拉起uim-xim与uim-toolbar-toolbar两个进程见 uim.nix。Hime轻量易用的输入法框架Hime 号称极易上手的输入法框架轻量、稳定、功能强大内置仓颉Cangjie、注音Zhuyin、大易Dayi、行列Rank、虾米Shrimp、希腊文、韩文拼音、拉丁字母等多种输入方案{ i18n.inputMethod { enable true; type hime; }; }hime.nix 的实现与其他 XIM 类框架一致设置GTK_IM_MODULEhime、QT_IM_MODULEhime、XMODIFIERSimhime并通过sessionCommands后台启动hime进程。KimeRust 编写的韩文输入法Kime 是一款使用 Rust 语言构建的韩文 IME主打简单、安全、快速的韩文输入体验{ i18n.inputMethod { enable true; type kime; }; }Kime 子模块kime.nix提供了独有的声明式配置能力最终生成的配置写入/etc/xdg/kime/config.yamlkime.daemonModuleslist默认[Xim Wayland Indicator]启用的守护模块列表可从Xim、Wayland、Indicator中挑选例如kime.daemonModules [ Xim Indicator ];kime.iconColorenum默认Black指示器图标颜色可选Black/Whitekime.extraConfiglines默认追加的原始 Kime 配置片段YAML 文本用于覆盖上述生成内容之外的更细节配置。对应的 YAML 生成逻辑为daemon.modules: [...]与indicator.icon_color: ...。注意旧选项i18n.inputMethod.kime.config已被移除须改用上述新选项。通用要点与选型建议公共行为无论选择哪个框架i18n.inputMethod模块都会把对应包加入environment.systemPackages并按框架需要生成 GTK immodule 缓存XIM 类框架Nabi、Uim、Hime、Kime普遍通过XMODIFIERS 会话启动命令工作而 IBus、Fcitx5 则提供了更现代的GTK_IM_MODULE/QT_IM_MODULE桥接与 Wayland 前端选项。因此桌面环境为 GNOME优先 IBus其自启脚本明确标注NotShowInGNOME;KDE;由 GNOME 通过 systemd 托管见 ibus.nix需要拼音/五笔/中州韵等丰富中文方案Fcitx5 生态最完整fcitx5-chinese-addons、fcitx5-rime等且支持完全声明式调校韩文专精Nabi、Kime 均可选Kime 配置面更现代多语言综合场景IBus引擎多或 Fcitx5插件多都是稳妥选择。常见坑位清单引擎装了没用IBus 引擎打包进运行环境后还需在 IBus 偏好设置中手动启用Wayland 会话下输入法失效确认是否应设置对应框架的waylandFrontend trueIBus 与 Fcitx5 均提供该选项并检查桌面对 Wayland 输入法协议的支持部分应用无法输入IBus 场景下用nix-store -q --requisites path | grep glib比对 glib 版本不一致则重装应用启用fcitx5.ignoreUserConfig后词库异常该选项会令用户词典无法保存与加载仅在确需锁定系统级配置时使用表格类引擎缺失IBus 使用table-others时必须同时加入table。以上所有配置均在nixos-rebuild switch后生效由于配置全部声明在 Nix 中切换输入法框架只需修改i18n.inputMethod.type并保持其余配置不变这正是 NixOS 声明式配置相比手工安装的最大优势。【免费下载链接】nixpkgsNix Packages collection NixOS项目地址: https://gitcode.com/GitHub_Trending/ni/nixpkgs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考