龙芯 loongnix25 下安装极点五笔教程

源码编译 · fcitx5 插件 · 实战踩坑

极点五笔是很多老用户从 Windows 时代就一直在用的输入法。2026 年 8 月，它的 Linux 源码正式在 openKylin 仓库开放，这让在国产平台上源码编译安装成为可能。本文记录在龙芯 3A6000 + loongnix 25（loongarch64，新世界 ABI 2.0）环境下，从下载源码到编译、安装、修复图标、最终可用的一整套过程。

一、缘起：为什么必须走源码编译

深度论坛上关于极点五笔 Linux 版最集中的反馈有两个（原帖见文末参考文档）：

• deb 包直接安装“少东西”，装不成功；
• fcitx4 版本在当前系统上无法使用——因为 deepin V25 等新系统默认的输入法框架已经是 fcitx5，fcitx4 插件自然注册不进去。
• 论坛里也有用户反馈，在 UOS1070 + 鲲鹏 920 平台上使用新版极点五笔“非常流畅”，说明这套源码本身是可用且成熟的，问题主要集中在

打包形态与输入法框架版本不匹配上。

本次环境与论坛场景的对应关系如下：

结论很明确：跳过 deb 包，直接源码编译 fcitx5 插件。

二、准备工作：安装编译依赖

freewb 的 fcitx5 版本需要以下依赖。可直接一条命令装齐：

sudo apt install g++ cmake libfcitx5core-dev libfcitx5config-dev \   libfcitx5utils-dev libxi-dev libxtst-dev libdbus-1-dev libsystemd-dev \   qtbase5-dev libqt5svg5-dev extra-cmake-modules libspdlog-dev libwayland-dev

装完后建议核验一遍，避免编译到一半才报错：

for pkg in g++ cmake libfcitx5core-dev libfcitx5config-dev libfcitx5utils-dev \   libxi-dev libxtst-dev libdbus-1-dev libsystemd-dev qtbase5-dev \   libqt5svg5-dev extra-cmake-modules libspdlog-dev libwayland-dev; do   dpkg -s "$pkg" >/dev/null 2>&1 && echo "OK   $pkg" || echo "MISS $pkg" done

三、下载源码

源码托管在 openKylin 的 Gitee 仓库，官方网盘也提供下载地址：

git clone https://gitee.com/openkylin/freewb.git

克隆完成后，源码根目录结构如下（关键目录）：

值得注意的是，libs/Linux/ 下已经提供了 loong64 的预编译库，这正是国产平台能顺利编译的前提。

四、修改源码（关键两处）

源码默认状态下，在本环境里是编译不过、且装上也认不出的。需要动两处。

4.1 fcitx5 兼容性修复：addon 配置缺少 Category 字段

这是最隐蔽的一个坑，也是社区修订（参考文档中的 commit）解决的核心问题。

文件：src/fcitx5/freewb-addon.conf.in

[Addon] Name=Freewb Input Method Library=libfreewb-fcitx5 Type=SharedLibrary Category=InputMethod      # <-- 新增这一行 OnDemand=True Configurable=False

原理：

fcitx5 在注册输入法时会调用 checkEntry 校验 addon 声明。缺少 Category=InputMethod 字段时，该输入法条目会被静默丢弃——既不报错，日志里也没有任何提示，表现为“装完了但是输入法列表里根本找不到极点五笔”。   

4.2 CMakeLists 架构判断语法错误

文件：CMakeLists.txt 第 30 行。

# 修改前（CMake 报错：Unknown arguments specified） if ($ENV{DEB_HOST_ARCH} STREQUAL "loong64")  # 修改后 if("$ENV{DEB_HOST_ARCH}" STREQUAL "loong64")

原理：

CMake 的 if() 命令中，$ENV{...} 裸引用（不加引号）会被当作变量名解析而非取值，导致参数解析失败、配置阶段直接中断。加双引号后 CMake 先展开再比较，逻辑恢复正常。   

该分支的作用是：当 DEB_HOST_ARCH=loong64 时选用 libs/Linux/loong64/ 下的预编译库并定义 __LOONG64__。loongnix 25 属新世界 ABI，应当走 loong64 分支。

五、编译与安装

配置时明确只启用 fcitx5，并指定 loong64 架构：

cd freewb mkdir build && cd build  DEB_HOST_ARCH=loong64 cmake .. \   -DCMAKE_INSTALL_PREFIX=/usr \   -DCMAKE_INSTALL_LIBDIR=lib/loongarch64-linux-gnu \   -DENABLE_FCITX4=Off \   -DENABLE_FCITX5=On \   -DENABLE_IBUS=Off \   -DENABLE_UKUI=Off  make -j$(nproc) sudo make install

本次在龙芯 3A6000 上编译全程无报错，最终生成 libfreewb-fcitx5.so。

安装完成后可以做一次结构核验，确认插件库、addon 配置、输入法条目、引擎文件都已就位：

安装结构核验

几个关键安装位置：

六、在 fcitx5 中启用极点五笔

安装完成后重启输入法框架使插件生效：

pkill fcitx5 && fcitx5 -d

随后打开 fcitx5 配置工具，在“当前输入法”中即可看到“极点五笔输入法”：

     若此处看不到“极点五笔输入法”，基本可以断定是 4.1 节的 Category=InputMethod 没有生效，请回头检查该字段是否已正确写入 /usr/share/fcitx5/addon/freewb.conf。   

七、修复“图标不显示”

输入法能用了，但托盘图标还是空的——这是另一个高频问题。根因有两条：

2. 图像资源只安装到了 hicolor 兜底主题的 scalable（矢量）目录，而当前桌面实际使用的图标主题是 mate；
4. 安装过程没有刷新图标主题缓存（icon-theme.cache），导致图标查找命中旧缓存而找不到目标图标。

其中第 2 条是决定性的。通过隔离实验验证：即使主题里只有 SVG 矢量图，只要刷新过缓存，图标就能被正确解析。

修复分两步。第一步补齐多尺寸位图（Qt 与 GTK 对图标的查找机制不同，位图更稳妥）：

SRC=/usr/share/icons/hicolor/scalable/apps/freewb.svg for s in 16 22 24 32 48 256; do   convert -background transparent "$SRC" -resize ${s}x${s} /tmp/freewb_${s}.png   cp /tmp/freewb_${s}.png /usr/share/icons/mate/${s}x${s}/apps/freewb.png done cp "$SRC" /usr/share/icons/mate/scalable/apps/freewb.svg

第二步刷新缓存：

gtk-update-icon-cache -f -t /usr/share/icons/mate/ gtk-update-icon-cache -f -t /usr/share/icons/hicolor/

修复后验证图标已被主题正确解析：

图标解析验证

托盘图标的对比最为直观：

图标修复前后对比

八、效果验证

切换到极点五笔后实测输入，候选窗正常工作：

极点五笔输入效果（输入码 trnt，候选“我 / 特性”）

托盘图标也已正确显示为极点五笔的“极”字图标：

托盘图标

至此，极点五笔在龙芯 loongnix 25 + fcitx5 环境下完全可用。

九、踩坑总结

参考文档

源码与社区

• 极点五笔源码仓库（openKylin）：https://gitee.com/openkylin/freewb
• 极点五笔官方网盘：http://freewb.ysepan.com/
• fcitx5 兼容性修订 commit（补充 Category=InputMethod）：https://gitee.com/yngeek/freeweb_depin/commit/4bd5d839575ac2e0a39a8eec0bf67c9b18cc1f9b
• 深度论坛原帖《极点五笔 linux 源代码来了》：https://bbs.deepin.org.cn/post/301002

本机路径

• 源码目录：~/freewb（构建目录 ~/freewb/build）
• fcitx5 插件库：/usr/lib/loongarch64-linux-gnu/fcitx5/libfreewb-fcitx5.so
• addon 声明：/usr/share/fcitx5/addon/freewb.conf
• 输入法条目：/usr/share/fcitx5/inputmethod/freewb.conf
• 图标资源：/usr/share/icons/mate/<size>/apps/freewb.*

环境信息

• 平台：龙芯 3A6000 / loongarch64 / 新世界 ABI 2.0
• 系统：Loongnix GNU/Linux 25
• 输入法框架：fcitx5 5.1.12
• 桌面环境：XFCE（图标主题 mate）
• —— 全文完 ——