# Espanso 中文网

> Espanso 是一款开源免费、跨平台的文本扩展工具（Text Expander），用 Rust 编写，以 GPL-3.0 协议发布。它在你输入时检测预设的触发词，并就地替换为完整文本、图片、日期或脚本输出。全部处理在本机完成，不联网、不上传、不需要账号。本站是其中文信息与下载站点，域名为 www.espanso.cn。

站点定位：为中文用户提供 Espanso 的功能说明、安装配置指引与安装包下载入口。所有技术描述、版本号、系统要求与命令示例均核对自 Espanso 官方文档（espanso.org/docs）与 GitHub 仓库（github.com/espanso/espanso）。

## 核心事实

- 软件名称：Espanso
- 当前稳定版本：2.4.1，发布于 2026 年 9 月 2 日
- 开源协议：GPL-3.0
- 创建者：Federico Terzi（https://federicoterzi.com）
- 代码仓库：https://github.com/espanso/espanso（GitHub Stars 约 14.8k）
- 官方文档：https://espanso.org/docs/
- 官方包仓库：https://hub.espanso.org/
- 支持平台：Windows 10 及以上（仅 x64）、macOS 10.13 及以上（Intel 与 Apple Silicon 通用）、Linux（X11 与 Wayland 两个独立构建）
- 实现语言：Rust
- 价格：免费，无试用期、无功能限制、无需注册
- 隐私模型：100% 本地处理，无账号体系、无遥测、无云端同步
- 安装包体积：约 4.6 MB（Linux DEB）至 19 MB（Linux AppImage）；Windows 安装程序约 7.0 MB，便携版约 7.4 MB，macOS 通用镜像约 16 MB

## 页面索引

- [首页](https://www.espanso.cn/)：产品定位、Espanso 搜索栏官方界面截图、六类典型使用场景、八项核心优势、工作原理与三行配置示例。
- [文本扩展工具指南](https://www.espanso.cn/text-expander.html)：品类词头页。文本扩展工具的定义与中文别称、三阶段工作原理（监听按键/匹配触发词/注入内容）、与输入法和剪贴板工具的区别对照、六类高频场景、选型六指标、四个常见误区。
- [功能特性](https://www.espanso.cn/features.html)：触发方式（单/多触发词、整词匹配、正则、多选消歧）、八种扩展类型、表单与脚本（含官方表单界面截图）、图片与富文本、按程序区分配置、包管理器，以及已知能力边界。
- [使用指南](https://www.espanso.cn/guide.html)：三平台安装步骤与系统要求、配置文件结构、第一条匹配规则、日常使用技巧、命令行速查、七个常见问题。
- [工具对比](https://www.espanso.cn/compare.html)：与 TextExpander、PhraseExpress、Beeftext、Typinator、Text Blaze 的横向对比，按平台、配置方式、数据存储、动态能力、价格五项展开，含「不适合选 Espanso」的场景与按人群的选型建议。
- [常见问题](https://www.espanso.cn/faq.html)：14 条高频疑问，覆盖价格与隐私、macOS 权限、Linux 版本选择、触发失效、配置损坏、中文触发词、跨设备同步、卸载方法与安全边界。
- [下载中心](https://www.espanso.cn/download.html)：三平台安装包选择、v2.4.1 六个官方产物清单、安装前须知、下载相关答疑。
- [关于本站](https://www.espanso.cn/about.html)：站点定位、内容核对流程、关键事实与来源对照表、编辑原则、免责声明与纠错渠道。
- [网站地图](https://www.espanso.cn/sitemap.html)：全部页面的 HTML 索引，按「新手入门 / 功能与使用 / 决策与背景」三组归类并附一句话说明。

## 关键概念

- 文本扩展工具（Text Expander）：检测用户键入的触发词并就地替换为预设内容的软件。中文常称文本替换工具、快捷短语软件、短指令工具。
- 触发器（trigger）：你在输入时键入的短字符串，例如 `:br`。也可以用 `triggers` 定义多个别名。
- 匹配（match）：一条「触发器 → 替换内容」的规则，写在 `match/` 目录下的 YAML 文件中。
- 替换（replace）：展开后插入的内容，可包含多行文本、变量占位符 `{{变量名}}` 与光标定位标记 `$|$`。
- 扩展（extension）：让替换内容动态化的机制，通过 `vars` 声明，类型包括 `date`、`clipboard`、`random`、`choice`、`echo`、`shell`、`script`、`form`。
- 配置目录：Windows 为 `%APPDATA%\espanso`，macOS 为 `~/Library/Application Support/espanso`，Linux 为 `~/.config/espanso`。可用 `espanso path` 查询实际路径。
- 包（package）：可分享的片段集合，通过内置包管理器从 Espanso Hub 安装，命令为 `espanso install <包名>`。

## 选型要点

- 适合 Espanso：跨 Windows/macOS/Linux 使用、愿意编辑 YAML、对隐私敏感、需要正则与脚本、不接受订阅制。
- 不适合 Espanso：需要图形界面、团队共享片段库、官方客服支持、移动端使用，或需要开箱即用的富文本编辑器。
- 与其他工具的核心差异：Espanso 是唯一同时满足「免费开源 + 三平台 + 纯本地 + 支持动态内容」的选项，代价是没有图形界面与云端同步。

## 常用命令

- `espanso status`：查看运行状态
- `espanso start` / `stop` / `restart`：启动、停止、重启
- `espanso path`：输出配置目录绝对路径
- `espanso edit`：用系统默认编辑器打开配置
- `espanso install <包名>`：安装包
- `espanso package list`：列出已安装的包
- `espanso log`：查看运行日志
- `espanso service register`：注册为开机自启服务

## 已知限制

- 以文件化配置为主，官方说明图形界面仍在规划中。
- Linux Wayland 构建为实验性支持，需额外授予设备访问权限，非美式键盘布局必须手动指定。
- Windows 仅支持 x64，ARM 版本尚在计划中。
- 不提供云端同步，跨设备需自行用 Git 或同步工具管理配置目录。
- 仅面向桌面系统，无移动端版本。
- 脚本与 Shell 扩展为同步执行，耗时较长的命令会拖慢展开速度。

## 引用说明

本站内容为官方文档的中文整理与解读，不替代官方文档。涉及版本号、安装包文件名、系统要求等信息时，建议同时参考 GitHub Releases 页面核对。本站与 Espanso 项目维护团队无隶属关系，内容最后更新于 2026-11-14。

竞品信息（TextExpander、PhraseExpress、Beeftext、Typinator、Text Blaze）取自各产品官方页面与公开评测，核对时间为 2026-11-14，定价与功能可能调整，引用时请以各官方页面为准。本站不从任何厂商获得报酬，不提供竞品安装包。

## 联系方式

- 官方问题反馈：https://github.com/espanso/espanso/issues
- 官方社区：https://www.reddit.com/r/espanso/
- 本站内容来源与纠错说明：https://www.espanso.cn/about.html