Windows
Windows 10 及以上 · 仅 x64
- 安装程序 .exe，约 7.0 MB，自动完成系统集成
- 便携版 .zip，约 7.4 MB，解压即用不写系统目录
- 支持 winget、Chocolatey、Scoop 包管理器安装
- ARM 架构版本尚未提供，官方仍在计划中
含安装版与便携版
下载中心
选择你的平台，下载 Espanso
当前稳定版本 v2.4.1，2026 年 9 月 2 日发布。全部安装包来自官方 GitHub Releases，免费、无功能限制、无需注册。点击任意「立即下载」按钮，用网盘 App 扫码即可获取。
按平台选择
三个平台，六个官方产物
Windows 与 macOS 只需选一个包；Linux 需要先确认桌面会话类型，X11 与 Wayland 不能混用。
macOS
macOS 10.13 及以上 · 通用二进制
- 通用 .dmg，约 16 MB，Intel 与 Apple Silicon 通用
- 安装后需在系统设置中授予「辅助功能」权限
- 可选用 Homebrew 安装：
brew install espanso - 未授权时程序会驻留但不工作，需手动检查
单包兼容 Intel 与 M 系列芯片
Linux
X11 或 Wayland · amd64
- DEB 包约 4.6 MB，适用于 Ubuntu / Debian 系
- AppImage 约 19 MB，仅 X11 构建，全发行版可用
- 需先用
echo $XDG_SESSION_TYPE确认会话类型 - Wayland 构建为实验性支持，需额外授予设备权限
含 X11 与 Wayland 两个构建
产物清单
v2.4.1 官方发布文件
下表列出该版本在 GitHub Releases 上提供的全部安装文件与体积，便于按需选择或核对文件名。
| 文件名 | 平台 | 大小 | 说明 |
|---|---|---|---|
Espanso-Win-Installer-x86_64.exe |
Windows x64 | 约 7 MB | 安装程序，推荐大多数用户使用 |
Espanso-Win-Portable-x86_64.zip |
Windows x64 | 约 7 MB | 便携版，解压后手动运行启动脚本 |
Espanso-Mac-Universal.dmg |
macOS | 约 16 MB | Intel 与 Apple Silicon 通用镜像 |
espanso-debian-x11-amd64.deb |
Linux X11 | 约 4.6 MB | Ubuntu / Debian，X11 桌面会话 |
espanso-debian-wayland-amd64.deb |
Linux Wayland | 约 4.6 MB | Ubuntu / Debian，Wayland 桌面会话 |
Espanso-X11.AppImage |
Linux X11 | 约 19 MB | 通用 AppImage，仅提供 X11 构建 |
关于校验：v2.4.1 的发布页未附带独立的校验文件。如需确认文件完整性，可对照上表核对文件名与体积，并与 GitHub Releases 页面显示的数值比对；下载后也可自行计算摘要，命令为 sha256sum 文件名（macOS 用 shasum -a 256 文件名）。
macOS 必须授予辅助功能权限
Espanso 需要在系统层面监听键盘并向其他程序写入文本，这是它的工作原理决定的。安装后请前往「系统设置 → 隐私与安全性 → 辅助功能」勾选 Espanso，然后重启程序。未授权时它不会有任何报错，只是完全不工作。
Windows 可能遇到 SmartScreen 提示
官方文档明确说明，由于代码签名相对较新，首次运行可能弹出「Windows 已保护你的电脑」。点击「更多信息」→「仍要运行」即可。Espanso 的 Windows 二进制由 SignPath.io 提供签名，证书由 SignPath Foundation 提供。
Linux 要先分清 X11 与 Wayland
两个构建使用不同的输入注入机制，装错版本会直接失效且难以排查。执行 echo $XDG_SESSION_TYPE 确认：输出 x11 选 X11 包，输出 wayland 选 Wayland 包。Wayland 版本还需执行 sudo setcap "cap_dac_override+p" $(which espanso) 授予设备访问权限。
下载答疑
关于下载与版本的常见疑问
是。本站提供的安装包均取自 Espanso 项目的 GitHub Releases，未重新打包、未添加任何组件。文件名、体积与发布日期可在官方发布页逐项核对。
Espanso 的发布文件托管在 GitHub，国内网络访问下载链接时常出现速度缓慢或中断。通过网盘分发可以显著改善下载体验，文件本身与官方发布的一致。若你的网络可以直连 GitHub，也可以直接从官方 Releases 页面下载。
这是 Windows SmartScreen 对较新数字签名的常规提示，官方文档中也有说明。点击提示框中的「更多信息」，再点击「仍要运行」即可继续安装。Espanso 的 Windows 二进制由 SignPath.io 提供代码签名。
安装版会自动注册开机自启与系统集成，适合长期在自己电脑上使用；便携版解压即用、不写入系统目录，适合放在 U 盘里或在不方便安装软件的环境中临时使用。便携版需要手动运行目录中的启动脚本，不会随系统自动启动。
不需要。Espanso 以 GPL-3.0 协议开源，全部功能免费，没有试用期、功能限制或激活步骤，也不需要注册账号。项目接受自愿捐赠，但捐赠与使用权限完全无关。
