5 分钟装好清风输入法 WindInput：Windows、macOS 与 Linux 三平台安装完全指南

清风输入法 WindInput 是一款轻量、快速、可定制的开源中文输入法，专为五笔和码表输入方案设计，同时提供全拼与双拼支持，一套 Rust 核心引擎横跨 Windows 10/11、macOS 12+ 与 Linux 三大平台。本文将带你完成清风输入法安装全流程：从下载安装包、系统设置激活，到 Linux Fcitx5 前端接入，最后附源码构建方法，全程约 5 分钟即可上手。

📋 安装前准备：系统与版本要求

在开始之前，先确认你的系统满足以下条件：

💡 清风输入法核心由 Rust 实现，资源占用低、启动迅速；输入方案、词库、主题等数据文件集中在仓库的 data/ 目录中维护，方案文件（如 wubi86.schema.toml、pinyin.schema.toml）决定了各输入方案的行为。

🪟 Windows 安装步骤：安装包一键完成

方式一：标准安装包（推荐）

1. 下载 Windows 64 位安装包WindInput-Setup-<版本>.exe（安装版或便携版均可）。
2. 双击运行，程序会自动请求管理员权限（输入法需要注册到系统），按向导完成安装。
3. 安装后按Win + Space切换到清风输入法，开始输入。

方式二：包管理器一键安装

如果你已使用 winget 或 Scoop，可以一行命令完成：

winget install WindInput.WindInput scoop install windinput-np

两者底层都是调用标准安装包，只是省去手动下载。相关清单维护在 scripts/pkg-managers/winget-manifest.sh 与 scripts/pkg-managers/scoop/windinput-np.json，打包机制细节见 docs/design/package-managers.md。

⚠️遇到 SmartScreen 拦截怎么办？Windows 版安装包已做数字签名，但新版本发布初期需要时间积累信誉，可能被 SmartScreen 拦截。此时点击「更多信息 → 仍要运行」即可继续，属于正常现象。

💾 卸载小提示：通过包管理器卸载会保留你的用户词库与设置（--keep-user-data机制）；如需彻底清除，请到「设置 → 应用」中走卸载向导。

🍎 macOS 安装步骤：pkg 包 + 系统设置激活

1. 下载 macOS 版.pkg通用安装包（Apple Silicon / Intel 通用）。
2. 双击安装后打开「系统设置 → 键盘 → 文本输入 → 编辑」，在输入法列表中添加清风输入法。
3. 之后从顶部输入法菜单（Ctrl + 空格或状态栏菜单）切换到清风即可。

⚠️ macOS 版尚未做苹果签名与公证，首次启动若被 Gatekeeper 拦下，到「系统设置 → 隐私与安全性」中放行即可。

macOS 端客户端源码位于 wind_macos/（Swift + IMKit 实现），本地构建打包可执行scripts/mac/dev.sh，详见 wind_macos/README.md。

🐧 Linux 安装步骤：deb 包接入 Fcitx5

Linux 上清风输入法以Fcitx5 addon（libwindinput.so）形式工作，按键交给 Rust 核心服务wind_input处理，输入逻辑、词库、候选全部在服务侧。官方提供 Ubuntu/Debian 的.deb安装包（构建脚本见 scripts/linux/package-deb.sh，包内布局、已知限制详见 wind_linux/README.md）：

第一步：确认系统使用 Fcitx5

Deepin 默认即 Fcitx5；Ubuntu 桌面请用系统「语言支持」把键盘输入法系统设为 Fcitx5，或执行：

im-config -n fcitx5

注销并重新登录。这是所有 Fcitx5 输入法的共同前提。

第二步：安装并注册

sudo apt install ./windinput_*.deb

随后打开「Fcitx5 配置」（fcitx5-configtool），把「清风输入法」加进输入法列表。

第三步：开箱即用

• Shift单击即可在中文/英文间切换，无需额外配置；
• 输入时按Ctrl+Shift+]唤起图形设置程序；
• 服务由 addon 在连不上时自动拉起，升级只需fcitx5 -rd。

⚠️KDE Plasma（Wayland）用户注意：需在「系统设置 → 键盘 → 虚拟键盘」中选择「Fcitx 5」并重新登录，否则 Wayland 原生应用中没有候选窗。

🛠️ 进阶玩法：从源码构建安装

适合想体验最新功能或参与开发的用户。通用要求是Rust stable 工具链（各平台额外依赖见下表），完整说明见 CONTRIBUTING.md：

克隆仓库后按平台执行构建脚本即可：

git clone https://gitcode.com/gh_mirrors/wi/WindInput cd WindInput

构建脚本会自动下载第三方词库数据（缓存于.cache/）并生成完整数据目录。各 crate 职责与仓库地图可查看根目录 AGENTS.md。

✅ 装好之后：快速验证清单

安装完成后，用这张清单确认一切正常：

• Windows：按Win + Space能切换出清风输入法，输入wubi相关码元出现五笔候选；
• macOS：输入法菜单中可切换到清风，中英文切换正常；
• Linux：Fcitx5 输入法列表中显示清风，Shift单击可切换中英；
• 通用：打开图形设置程序，调整一次主题（亮/暗）或方案（全拼/双拼/五笔），修改即时生效。

❓ 常见问题速查

项目采用 MIT 许可证 开源，词库第三方数据声明见 NOTICE.md。祝你安装顺利，五笔拼音随心切换！🎉