先看这两个条件
- 当前公开 Linux 包面向 x86_64 / amd64。飞腾、鲲鹏等 ARM64，以及龙芯、申威、RISC-V 机器，不能安装这些 x86_64 包；发行版名称相同也不代表 CPU 相同。
- Fcitx4 的命令通常是 fcitx，Fcitx5 的命令是 fcitx5；IBus 是第三种框架。4 与 5 的插件不通用，不能改名混装。不要为了安装码圈删除搜狗、讯飞或整个系统输入法框架。
国产系统版本与框架对照
当前包要求系统 glibc 至少 2.28；Fcitx4 至少 4.2.9.6，Fcitx5 至少 5.0.21。安装工具会继续检查 GTK 等其他依赖。满足版本要求不等于已在每个国产系统镜像上通过整机测试。
核对日期：2026-09-23。下面区分官方资料与用户反馈，不是全系列兼容认证。发行版、桌面环境、系统升级和 CPU 架构都会影响安装结果；最终以本机检测及软件包依赖检查为准。
| 系统版本 | 框架选择 | 依据与注意事项 |
|---|---|---|
| 银河麒麟桌面 V10 SP1 | Fcitx4 | 官方 V10 文档使用 fcitx；用户实测为 4.2.9.9。选择 Fcitx4 DEB，并检查系统依赖。 |
| 银河麒麟桌面 V11 | 先检测；所报机器为 Fcitx4 | 用户实测 4.2.9.9，旧包曾安装后无法添加；尚不能据此宣称 V11 全系列已适配。 |
| 统信 UOS 桌面 V20 | 常见 Fcitx4，仍以本机为准 | 官方知识库提供 fcitx 的配置和重启方式；用户实测 4.2.9.32。专业版、家庭版及升级机器可能不同。 |
| 统信 UOS 桌面 V25 | 先检测；所报机器为 Fcitx4 | 用户实测 4.2.9.32，旧包曾无法添加。不要因为版本号是 25，就按 deepin 25 选择 Fcitx5。 |
| deepin 20.x | 常见 Fcitx4；可被用户改成 Fcitx5 | 官方资源页另列升级 Fcitx5 的教程。使用哪一套，就选对应包。 |
| deepin 23 / 25.x | 优先核对 Fcitx5 | 官方 25.1 公告提供 fcitx5-table-wubi98；用户 deepin 25 实测为 5.1.1。所报自定义码表导入问题仍待专项复核。 |
| openKylin 开放麒麟 2.0 / 3.0 | Fcitx5 | 官方 2.0 发布说明与 3.0 UKUI 4.24 文档明确涉及 Fcitx5；用户 3.0 实测能添加并导入码表。 |
| Ubuntu Kylin 优麒麟 22.04 / 24.04 | 检测当前桌面，不按名称猜测 | 与银河麒麟、开放麒麟是不同发行版；本轮未取得足以统一各镜像默认框架的官方依据，未做整机认证。 |
| openEuler 24.03 LTS / 25.03 桌面环境 | 随桌面及仓库而异 | 官方 25.03 文档列有 Fcitx5 组件；GNOME、KDE 等需分别检测。RPM 可用性还取决于依赖，不代表全系列兼容。 |
查看官方核对资料与实测说明
- 银河麒麟 V10 官方产品白皮书（输入法章节）
- 统信官方适配经验库：输入法与 fcitx
- deepin 官方 25.1 内测公告：Fcitx5 输入法
- deepin 官方常用资源（含 20.3 升级 Fcitx5 的条目）
- openKylin 2.0 官方发布说明
- openKylin 3.0：UKUI 4.24 输入法生态
- openEuler 25.03 官方已修复问题（Fcitx5 组件）
用户反馈来自本次提供的六系统测试表，未注明硬件架构和完整镜像编号。尤其 V11、UOS V25，不能把一台机器的版本推广为整个发行版的默认值。搜狗、讯飞是输入法名称，单凭名称不能判断 Fcitx4 或 Fcitx5。
第一步：在当前桌面终端检查
uname -m
pgrep -a -u "$(id -u)" -x fcitx
pgrep -a -u "$(id -u)" -x fcitx5
pgrep -a -u "$(id -u)" -x ibus-daemonuname 输出 x86_64 才对应当前包。其余命令哪条显示运行中的进程，就优先选择对应框架；没有输出不等于机器坏了，可能尚未启动输入法。可再运行 fcitx -v 或 fcitx5 -v 查看安装版本。在 SSH、root 终端或同时运行多个框架时，自动判断可能不明确，请回到日常登录用户的桌面终端操作。
第二步：同一个安装脚本，按需自动或明确选择
curl -fsSLo install-maquan-linux.sh https://maquan.app/install-maquan-linux.sh
bash install-maquan-linux.sh --dry-run
bash install-maquan-linux.sh先下载脚本，可自行查看内容；--dry-run 只显示检测和计划，不安装。正常执行时脚本展示选中的框架及包名，再请求确认，必要时通过 sudo 获取安装权限。无法明确识别时不会替你猜。
# 已确认使用 Fcitx4
bash install-maquan-linux.sh --framework fcitx4
# 已确认使用 Fcitx5
bash install-maquan-linux.sh --framework fcitx5
# 已确认使用 IBus
bash install-maquan-linux.sh --framework ibus三条命令只选与你当前桌面一致的一条。Fcitx4 当前提供 DEB；Fcitx5 / IBus 提供 DEB 与 RPM。框架识别不等于系统依赖已满足：系统过旧、软件源不全、只读系统或单位安全策略仍可能阻止安装，请保留报错，不要强制忽略依赖或关闭系统安全保护。
也可以手动下载安装
# DEB：三选一，文件先从官网下载
sudo apt install ./MaQuanIME-Linux-Fcitx4-0.1.86-amd64.deb
# 或 Fcitx5
sudo apt install ./MaQuanIME-Linux-Fcitx5-0.1.86-amd64.deb
# 或 IBus
sudo apt install ./MaQuanIME-Linux-IBus-0.1.86-amd64.deb
# RPM：按当前框架二选一
sudo dnf install ./MaQuanIME-Linux-Fcitx5-0.1.86-1.x86_64.rpm
# 或 IBus
sudo dnf install ./MaQuanIME-Linux-IBus-0.1.86-1.x86_64.rpm使用 apt install ./文件名.deb，而不是只用 dpkg -i，以便系统检查并补齐依赖。三个码圈前端共用安装文件，只装一个；换装码圈前端可能替换原来的码圈包，但不需要移除系统 Fcitx/IBus 框架。个人词库默认保留，重要数据仍建议先导出。
第三步：重启并添加输入法
- 01
重启
安装或升级后完整重启电脑，避免旧输入法进程仍在运行。
- 02
Fcitx4
从托盘输入法图标进入配置，或运行 fcitx-configtool / fcitx-config-gtk3。点加号，必要时取消「只显示当前语言」，搜索「码圈」并添加。UOS、麒麟也可能在控制中心的键盘与语言页面提供这一入口。
- 03
Fcitx5
运行 fcitx5-configtool，或从托盘进入配置，把「码圈输入法」加入当前输入法列表。deepin 可在控制中心的设备、键盘、输入法管理中添加。
- 04
IBus
在桌面「设置 → 键盘 → 输入源 → 中文」添加码圈，或打开 ibus-setup。菜单名称依桌面环境略有不同。
- 05
验证并导入自己的表
在普通文本编辑器中切到码圈，先试拼音或内置五笔，再打开码圈设置的方案管理导入自己的码表。Fcitx4 状态栏菜单较少，设置程序也可从应用菜单或 jdime-settings 命令打开。
装上了却无法添加，怎么办
- 先看是否装错 Fcitx4 / Fcitx5 包，再核对 uname -m 与文件名架构。仅看到软件包已安装，不代表插件已成功加载。
- 重启后仍搜不到：保存 fcitx-diagnose 或 fcitx5-diagnose 输出，并提供系统完整版本、CPU 架构及安装报错。不要照搬网上删除整个输入法配置目录的命令。
- 遇到 GLIBC、GLIBCXX、缺少共享库或依赖版本提示，属于系统依赖问题，不能靠把插件改名解决；不要手工替换系统 libc。
- deepin 25 等只读系统应使用官方支持的安装方式；单位受管电脑请由管理员处理。自定义码表导入失败需要附原文件格式和错误提示，不能归因于所有 Fcitx5 都不支持导入。
更新与卸载
官方包会配置码圈软件源，后续按系统正常更新即可。卸载只移除实际安装的码圈包，例如 sudo apt remove maquan-ime-fcitx4；RPM 用 sudo dnf remove maquan-ime-fcitx5 或 maquan-ime-ibus。不要使用 fcitx* 之类通配符卸载，以免删掉系统及其他输入法。