在银河麒麟 V11 上安装清风输入法教程
️ 重要提醒
清风输入法官方文档仅明确支持 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. 添加输入法
   在「输入法」页：

务必取消勾选「仅显示当前语言」——这是搜不到清风的最常见原因
在左侧列表搜索「清风」或「WindInput」
添加到右侧当前输入法组
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
用户数据保留在以下目录，如需彻底清理可手动删除：

用途 路径
用户配置 ~/.config/WindInput/
用户词库与数据 ~/.local/share/WindInput/
日志 ~/.local/share/WindInput/logs/
程序与内置词库 /usr/lib/windinput/
附：常见问题速查
问题 原因 解决
当前模式禁止执行（unpack）操作 系统保护机制拦截 先 sudo mm-cli -o 开维护模式，重启后再装
Higher LIBC6_2.34 GLIBC 版本过低 无法直接解决，建议反馈给开发者或改用自带输入法
Fcitx5 配置里搜不到清风 未运行 windinput-setup 或未注销重登 运行初始化脚本并重启
取消勾选「仅显示当前语言」后仍搜不到 引擎未加载 fcitx5-remote -r 或 killall fcitx5 && fcitx5 -d
Shift 单击不能切换中英 Fcitx5 全局热键占用 在「全局选项」里清空左 Shift 热键
总结一句话
在银河麒麟 V11 上装清风输入法的关键是——先开维护模式解除系统保护，用 apt 而非 dpkg 安装，装完运行 windinput-setup 初始化，最后注销重登并在 Fcitx5 配置里取消「仅显示当前语言」后添加。GLIBC 版本是潜在的硬性障碍，遇到时需向开发者反馈。
银河麒麟 V11 安装清风输入法教程 · 基于实际安装过程整理