Espanso：隐私优先的跨平台开源文本扩展器 #

Espanso 是什么？ #

Espanso 是一款隐私优先、完全开源的跨平台文本扩展器（Text Expander），由开发者 Federico Terzi 创建，采用 GPL-3 开源协议发布，可在 Windows、macOS 与 Linux 上运行。它的核心工作方式是：在你打字的过程中自动识别预设的关键词（Trigger），并实时将其替换为事先定义好的内容（Replace）——这套「触发器 + 替换内容」的规则被称为 Match。

无论是客服回复模板、销售话术、医疗报告、代码片段，还是今天日期、表情符号、终端命令输出，Espanso 都能一次配置、长期复用。由于所有匹配规则都保存在本地 YAML 文件中、不依赖云端账号，它在提升输入效率的同时也兼顾了隐私安全，非常适合经常处理重复文本的写作者、程序员与办公人群。

Espanso 有哪些亮点特色？ #

• 隐私优先，本地运行：所有匹配规则与配置都保存在本机文件中，无需注册账号、不上传任何输入内容，敏感文本替换也能安心使用。
• 真正的跨平台：同一套配置思路贯穿 Windows、macOS 与 Linux（X11 / Wayland），换系统不必重新学习；macOS 版本为 Universal 通用二进制，同时支持 Intel 与 Apple Silicon。
• 开源且免费：基于 GPL-3 协议开源，代码托管于 GitHub，任何人都可以审查、修改与分发，长期使用无授权成本。
• 输入即替换的 Match 机制：:espanso、:br、e'、signature、>>up 等任意字符串都能作为触发器，替换结果可以是多行文本、图片、脚本输出等，一个「原因」对应一个「结果」，扩展能力远超普通文本替换。
• 快捷搜索栏：记不住快捷键也没关系，按下 ALT+Space 即可唤出 Espanso 的搜索栏，直接检索并插入需要的片段。
• 日期与表情随手可用：不必再纠结日期格式，Espanso 可轻松插入过去与未来的日期；表情符号也能通过一个快捷键在所有常用应用中输入。
• 包生态与无限扩展：通过 Packages 可以安装数学符号、德语重音字符等现成能力，也可以在 Espanso Hub 上创建并分享自己的包，社区里甚至还有 ¯\_(ツ)_/¯。
• Shell、脚本与表单支持：面向进阶场景，片段可以调用 shell 命令或自定义脚本，把终端输出直接注入到当前应用中；表单（Forms）则可用于处理可复用的复杂工作流，并支持把表单值转发给脚本。
• 系统级集成与文件化配置：Espanso 兼容绝大多数应用，效率提升覆盖全系统；配置遵循 Unix 哲学，使用简单的 YAML 文件（如 match/base.yml 定义做什么、config/default.yml 定义怎么做），并支持按应用单独配置。

免费下载 Espanso #

以下为官方提供的各平台安装包（通过夸克网盘分享），点击链接即可下载。官方原站同样提供 Windows 安装版 / 便携版与 macOS 磁盘映像的直接下载。

提示：Linux 用户可前往官网安装页面，按发行版选择 DEB 包、Terra RPM 包或 AppImage；Windows 用户也可以使用 winget、Chocolatey、Scoop 等包管理器安装。

Espanso 如何使用？ #

Espanso 的设计理念是「配置一次，随处生效」，上手流程非常轻量：

1. 确认 Espanso 正在运行：macOS 与 Windows 用户可在状态栏看到 Espanso 图标；Linux 用户可打开终端执行 espanso status，若显示未运行，执行 espanso start 启动。

2. 验证第一个片段：打开任意一个可输入文字的应用（如记事本、TextEdit），输入 :espanso，你会看到它立刻变成 Hi there!。

3. 找到配置文件目录：执行 espanso path 可以打印配置目录路径。默认位置为：Linux $XDG_CONFIG_HOME/espanso、Windows %APPDATA%\espanso、macOS $HOME/Library/Application Support/espanso。该目录通常包含 config/default.yml（定义怎么做）与 match/base.yml（定义做什么）两个关键文件。

4. 创建你自己的 Match：用任意文本编辑器打开 match/base.yml，在 matches: 下追加规则即可。例如想快速输入邮件落款，可以写成：

   matches:
     - trigger: ":espanso"
       replace: "Hi there!"
     - trigger: ":br"
       replace: "Best Regards,\nJon Snow"
   

   保存后输入 :br，就会被替换成对应的两句落款。注意保持缩进（建议使用空格而非 Tab），否则 YAML 语法不生效。

5. 用搜索栏找片段：记不住触发器时，按下 ALT+Space 打开搜索栏，输入关键词即可检索并插入匹配内容。

6. 进阶玩法：需要插入终端输出时，可以在片段中调用 shell 命令或自定义脚本；需要处理复杂流程时，可以使用表单（Forms）构建可复用的模板，并支持把表单值转发给脚本；还可以按应用拆分配置文件，例如只在 VS Code 中启用某组代码片段。

7. 按应用定制行为：config/default.yml 中的选项默认应用于所有应用，你也可以为特定应用创建独立配置，例如全局启用表情片段、但在 Slack 中关闭。

Espanso 的常见问题？ #

Espanso 是免费的吗？ 是的。Espanso 是完全开源软件，采用 GPL-3 许可证，所有功能均可免费使用。作者 Federico 接受自愿捐赠（PayPal）以支持项目持续开发，但捐赠并非使用前提。

Espanso 支持哪些操作系统？ 官方支持 Windows、Linux 与 macOS 三大平台。macOS 需要 10.13 或更高版本，同时支持 Intel 与 Apple Silicon；Windows 兼容 Windows 10 或更高版本，目前仅支持 x64 架构，官方表示 ARM 支持已在计划中。

为什么我输入 :espanso 没有反应？ 最常见的原因是 Espanso 没有运行。macOS / Windows 用户请检查状态栏是否有 Espanso 图标，没有就重新点击 Espanso 应用启动；Linux 用户在终端执行 espanso status 确认状态，必要时执行 espanso start。若仍无效，建议按官网指引重新安装。

Windows 安装时弹出安全警告怎么办？ 由于 Espanso 的数字签名较新，Windows SmartScreen 可能会给出提示。此时点击「更多信息」（More info），再点击「仍要运行」（Run anyway）即可继续安装。

Linux 上应该选择哪种安装方式？ 首先要确认桌面环境是 X11 还是 Wayland，可在终端执行 echo $XDG_SESSION_TYPE 查看。Ubuntu / Debian 推荐使用 DEB 包，Fedora 推荐 AppImage 或 Terra RPM 包，Arch / Manjaro 及其他发行版推荐 AppImage 或手动编译。需要注意的是，Wayland 支持目前仍属实验性，部分功能可能缺失或表现不稳定。

配置文件的格式是什么？容易写错吗？ 配置使用 YAML 格式，结构清晰但对缩进敏感。请确保缩进正确（优先使用空格），否则触发器不会生效。若希望获得更友好的编辑体验，可以尝试 EspansoEdit、VSCode（VSCodium）或 Neovim 等编辑器；官网也提到图形界面正在规划中。

Mac 用户可以用 Homebrew 安装吗？ 可以。执行 brew install espanso 即可，安装完成后会在 /Applications 中生成 Espanso 应用。如果你是从 0.7.3 等旧版本升级而来，可能需要先执行 brew untap federico-terzi/espanso 或 brew untap espanso/espanso 移除旧的 tap。

Espanso 如何安装？ #

Windows（10 或更高版本，x64） #

1. 下载 Espanso-Win-Installer-x86_64.exe，双击运行安装程序；如果只是临时使用，也可以下载 Espanso-Win-Portable-x86_64.zip 解压后直接运行便携版。
2. 若出现 Windows SmartScreen 提示，点击「更多信息」→「仍要运行」。
3. 安装完成后，Espanso 会自动运行，状态栏出现 Espanso 图标即表示成功。
4. 也可以改用包管理器：
   • winget：winget install --id=Espanso.Espanso -e
   • Chocolatey：choco install espanso
   • Scoop：scoop bucket add main 后执行 scoop install main/espanso

macOS（10.13 或更高版本，Intel / Apple Silicon） #

1. 下载 Espanso-Mac-Universal.dmg 通用二进制磁盘映像。
2. 打开磁盘映像，把 Espanso 应用拖入 /Applications 文件夹。
3. 启动 Espanso，若出现安全警告，按官网 macOS 安装章节的说明处理。
4. 也可以使用 Homebrew：brew install espanso。若从 0.7.3 等旧版本升级，先执行 brew untap federico-terzi/espanso（或 brew untap espanso/espanso）移除旧 tap。

Linux（X11 / Wayland） #

先用 echo $XDG_SESSION_TYPE 判断桌面环境，再选择安装方式。

1. DEB 包（Ubuntu / Debian，推荐）：下载后执行 sudo apt install ./espanso-debian-x11-amd64.deb。可选：在 GitHub Releases 页面的 espanso-debian-x11-amd64-sha256.txt 中校验 SHA256。安装过程中出现的 N: Download is performed unsandboxed as root 提示可以安全忽略。

2. Terra RPM 包（Fedora 系）：先按 Terra 官方说明配置其主仓库，然后执行 sudo dnf install espanso-x11。Terra 通过 GitHub Actions 自动构建并签名包，DNF 安装与升级会进行完整性校验，但请注意它也会包含预发布版本。

3. AppImage（适用于所有发行版）：

   mkdir -p ~/opt
   wget -O ~/opt/Espanso.AppImage 'https://github.com/espanso/espanso/releases/latest/download/Espanso-X11.AppImage'
   chmod u+x ~/opt/Espanso.AppImage
   sudo ~/opt/Espanso.AppImage env-path register
   

4. 源码编译：需要较新的 Rust 编译器、C/C++ 编译器以及 build-essential git libx11-dev libxtst-dev libxkbcommon-dev libdbus-1-dev libssl-dev libwxgtk3.*-dev（Ubuntu / Debian）。克隆仓库后执行 cargo build -p espanso --release --no-default-features --features vendored-tls,modulo，再将 target/release/espanso 移动到 /usr/local/bin/。

5. 注册并启动服务（以上方式安装完成后通用）：

   espanso service register   # 只需执行一次
   espanso start
   

   如果不希望以 Systemd 服务方式运行，可以改用 espanso start --unmanaged，但此时 Espanso 不会随系统自动启动，需要手动开启。

6. 执行 espanso --version 可以验证命令行工具是否可用。

Espanso 如何卸载？ #

官网文档未单独提供卸载章节，以下为各平台通行的标准卸载流程，并额外说明需要手动清理的配置目录。

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（或「控制面板 → 程序和功能」），找到 Espanso，点击卸载。
2. 如果使用的是便携版，直接删除解压出来的文件夹即可（注意保留或备份你的配置文件）。
3. 如需彻底清理，可手动删除配置目录 %APPDATA%\espanso（例如 C:\Users\用户名\AppData\Roaming\espanso），其中保存着你的 Match 与配置。
4. 通过 winget / Chocolatey / Scoop 安装的用户，也可以分别使用 winget uninstall Espanso.Espanso、choco uninstall espanso、scoop uninstall espanso 卸载。

macOS #

1. 打开「应用程序」文件夹，将 Espanso 应用拖入废纸篓并清空（或使用 brew uninstall espanso 卸载 Homebrew 版本）。
2. 如需彻底清理，删除配置目录 $HOME/Library/Application Support/espanso（例如 /Users/用户名/Library/Application Support/espanso）。
3. 若开启过开机自启或辅助功能授权，建议在「系统设置 → 通用 → 登录项」与「隐私与安全性 → 辅助功能」中一并移除相关条目。

Linux #

1. 先注销并停止 Espanso 服务：espanso service unregister，必要时先执行 espanso stop。
2. 按安装方式移除软件包：
   • DEB 包：sudo apt remove espanso
   • Terra RPM 包：sudo dnf remove espanso-x11
   • AppImage：直接删除 ~/opt/Espanso.AppImage 即可（若已注册别名，可通过 AppImage 自带的 env-path 相关命令注销）。
   • 源码安装：删除 /usr/local/bin/espanso。
3. 如需彻底清理，删除配置目录，通常位于 $XDG_CONFIG_HOME/espanso（例如 /home/用户名/.config/espanso），或你自己迁移到的 $HOME/.config/espanso。删除前建议先备份 match/ 与 config/ 目录，以便日后在其他平台复用这些片段。