⚠️ 重要提醒
清风输入法官方文档仅明确支持 Ubuntu 22.04+ 和 Deepin 25。在银河麒麟 V11 上安装属于非官方支持场景，可能遇到兼容性问题，本教程仅供有需要的用户参考。

背景说明

银河麒麟 V11 默认开启了系统保护机制（磐石保护 / 不可变系统），会阻止 apt、dpkg 修改系统文件。同时，系统的 GLIBC 版本可能低于清风输入法安装包的要求。因此直接安装会失败，需要按特定流程操作。

一、前置检查

打开终端，确认以下信息：

1. 检查系统架构

uname -m

• 输出 x86_64 → 下载 amd64 版本
• 输出 aarch64 → 下载 arm64 版本

2. 检查 Fcitx5 是否可用

pgrep -a fcitx5

有输出说明 Fcitx5 已在运行。如果没有，可先启动：

fcitx5 -d --replace

二、开启维护模式 关键

银河麒麟 V11 的保护机制会拦截 apt 的写操作。必须先开启维护模式：

sudo mm-cli -o

然后重启系统：

sudo reboot

重启后系统进入维护模式，此时允许修改系统文件。

三、安装清风输入法

1. 获取安装包

从清风输入法官网或 GitHub Releases 下载对应架构的 .deb 包，例如：

WindInput125.0-amd64.deb

2. 使用 apt 安装（推荐，而非 dpkg）

apt 会自动处理依赖，dpkg 不会。进入 deb 包所在目录后执行：

sudo apt install ./WindInput125.0-amd64.deb

安装过程中会一并安装 fonts-noto-color-emoji、xauth、xclip 等依赖。

3. 安装成功的标志

看到类似输出即表示成功：

正在设置 windinput (0.125.0) ...
清风输入法已安装。请对每个使用者运行一次： windinput-setup   然后注销并重新登录

4. 关于 debconf 的提示

安装时可能出现：

debconf: 无法初始化前端界面：Dialog
debconf: 返回前端界面：Readline

这是正常现象，只是界面回退到文本模式，不影响安装。

四、初始化用户配置

安装包只放了程序文件，每个用户还需要运行一次初始化脚本，输入法才会被注册到 Fcitx5：

windinput-setup

如果提示找不到命令，可以先用下面的命令定位：

dpkg -L windinput | grep -i setup

然后用完整路径运行。

五、注销并重新登录

这一步不能省略，也不能用 fcitx5 -rd 替代：

sudo reboot

或直接注销当前用户再登录，让 Fcitx5 在新会话里加载引擎。

六、在系统中添加清风输入法

1. 打开 Fcitx5 配置

fcitx5-configtool

或从应用菜单打开「Fcitx 5 配置」。

2. 添加输入法

在「输入法」页：

1. 务必取消勾选「仅显示当前语言」
   ——这是搜不到清风的最常见原因
2. 在左侧列表搜索「清风」或「WindInput」
3. 添加到右侧当前输入法组

3. 切换输入法

默认热键 Ctrl + Space 切换到清风输入法。

4. 想用 Shift 单击切换中英？

Fcitx5 出厂把「临时在当前和第一个输入法之间切换」设为左 Shift，会截走单击动作。需要到「全局选项」里，把这个热键清空或改键。

七、关闭维护模式（推荐）

软件安装完成后，为了系统安全，建议退出维护模式：

sudo mm-cli -c -a
sudo reboot

-a 参数表示保留期间安装的软件和数据，仅关闭维护模式本身。

八、验证与排查

1. 确认安装位置

dpkg -L windinput | head -20

正常情况下程序文件在 /usr/lib/windinput/。

2. 确认 Fcitx5 加载了引擎

fcitx5-remote -m

输出里应能找到 windinput 或清风相关条目。

3. 如果列表里依然搜不到

按顺序尝试：

# 重新加载运行时注册表
fcitx5-remote -r

# 完全重启 Fcitx5
killall fcitx5 && fcitx5 -d

仍不行则运行诊断：

fcitx5-diagnose 2>&1 | grep -i wind

重点看有没有 Failed to load addon 之类的报错。

九、可能遗留的问题：GLIBC 版本

银河麒麟 V11 的 GLIBC 版本可能低于清风输入法要求的 2.34。表现是：

• 安装成功、文件都在
• 但引擎加载失败，或 windinput-setup 报 GLIBC 相关错误

不要强行升级系统 GLIBC
那会导致整个系统程序大面积崩溃，甚至无法进入桌面。可行的替代方案：关注清风输入法是否发布对低 GLIBC 版本系统的适配版本；到清风输入法 GitHub 仓库提 issue 反馈；或暂时改用系统自带的输入法。

十、升级与卸载

升级

下载新版 .deb，同样用 apt 覆盖安装（如已在维护模式外，需先重新开启维护模式）：

sudo apt install ./WindInput新版本.deb

然后重启或注销重登。

卸载

sudo apt remove windinput

用户数据保留在以下目录，如需彻底清理可手动删除：

附：常见问题速查

总结一句话
在银河麒麟 V11 上装清风输入法的关键是——先开维护模式解除系统保护，用 apt 而非 dpkg 安装，装完运行 windinput-setup 初始化，最后注销重登并在 Fcitx5 配置里取消「仅显示当前语言」后添加。GLIBC 版本是潜在的硬性障碍，遇到时需向开发者反馈。