espanso

espanso — 一个开源跨平台的文本扩展器，让你用简短缩写自动替换成常用短语、代码模板或日期时间。

去年年底我换了新电脑，从Windows切换到macOS，最头疼的事之一就是那些日常重复输入的文本——邮箱地址、常用代码片段、Markdown模板、甚至“稍后回复”的客套话。每次都要重新打一遍，或者翻找笔记复制粘贴，效率低得让人抓狂。

然后我遇到了espanso。它是个开源的文本扩展工具，跨平台（Windows、macOS、Linux），核心功能很简单：你输入一个简短的“触发词”（比如:mail），它自动替换成你预设的长文本（比如你的完整邮箱地址）。听起来像键盘热键或输入法自带的短语库？不，它比那些强大得多。

它到底能解决什么问题？

想象一下这些场景：

• 你每天要回复十几封邮件，每次都要打“感谢您的来信，我会尽快处理”——用espanso，输入:ty就搞定。
• 写技术文档时，频繁插入代码块的Markdown格式（python ... ）——输入:codeblock自动补全。
• 在聊天软件里跟同事说“稍等，我查一下”——输入:brb秒变“Please hold on, I'm checking...”。
• 日期时间格式总记不住，输入:today自动插入“2025-02-18”这种标准格式。

它本质上是一个“文本自动补全引擎”，但不止于此。espanso支持动态变量（比如当前日期、剪贴板内容、随机数），还能执行脚本、调用Shell命令，甚至通过插件扩展。可以说，它把“重复输入”这件事彻底自动化了。

下载和安装

官方下载地址在这里：espanso官网。下载安装包后，不同系统的安装方式略有区别：

macOS：下载.dmg文件，拖到Applications文件夹。首次启动会要求授权“辅助功能权限”，因为espanso需要监听键盘输入。去系统设置→隐私与安全性→辅助功能里勾选espanso就行。

Windows：下载.exe安装包，一路Next。安装完成后右下角任务栏会出现图标，右键可以管理配置。

Linux：推荐用包管理器安装，比如Ubuntu/Debian用sudo apt install espanso，或者从GitHub Releases下载AppImage。

安装完后，打开终端（或cmd）运行一次espanso start，它会自动创建配置文件目录。macOS/Linux在~/.config/espanso/，Windows在%APPDATA%\espanso\。

基础使用教程

espanso的配置核心是一个YAML文件：default.yml。打开它，你会发现结构非常清晰：

matches:
  # 简单文本替换
  - trigger: ":mail"
    replace: "yourname@example.com"

  # 多行文本（用|管道符）
  - trigger: ":sig"
    replace: |
      Best regards,
      张三
      产品经理
      tel: 138-0000-0000

  # 带日期的动态内容
  - trigger: ":today"
    replace: "{{today}}"

保存文件后，在任意输入框输入:mail，它会立刻替换成你的邮箱。注意触发词前面的冒号是习惯用法，防止误触（比如你打“mail”本身不会触发）。

常用内置变量：

• {{today}}：当前日期（格式可自定义，默认YYYY-MM-DD）
• {{now}}：当前时间（HH:mm:ss）
• {{clipboard}}：剪贴板内容
• {{random}}：随机数字

进阶一点：你可以在替换文本里用{{clipboard}}实现“先复制，再输入触发词自动粘贴”的效果。比如：

- trigger: ":paste"
  replace: "{{clipboard}}"

这样输入:paste就会自动粘贴刚才复制的内容，比Ctrl+V多了一个“确认感”——适合在终端或某些禁用粘贴的输入框里用。

进阶技巧：让espanso真正成为你的“第二大脑”

1. 多配置文件管理

别把所有东西塞进default.yml。按场景拆分：

• email.yml：所有邮箱相关模板
• code.yml：代码片段（JSON、SQL、Python等）
• personal.yml：地址、电话、身份证号等

在default.yml里通过imports引入：

imports:
  - "email.yml"
  - "code.yml"
  - "personal.yml"

2. 使用Shell命令扩展

espanso可以执行Shell命令并输出结果。比如生成一个UUID：

- trigger: ":uuid"
  replace: "{{output}}"
  vars:
    - name: output
      type: shell
      params:
        cmd: "uuidgen"  # macOS/Linux
        # 或 "powershell -Command [guid]::NewGuid()" Windows

每次输入:uuid，它会调用系统命令生成一个新的UUID，直接替换。

3. 条件触发和表单

这是espanso的隐藏大招。你可以创建带输入框的“表单”，让替换内容动态变化：

- trigger: ":bug"
  replace: "Bug: {{bugname}}\n优先级: {{priority}}\n描述: {{description}}"
  vars:
    - name: bugname
      type: form
      params:
        label: "Bug名称"
    - name: priority
      type: form
      params:
        label: "优先级 (高/中/低)"
    - name: description
      type: form
      params:
        label: "描述"

输入:bug后，会弹出三个输入框，填完后自动生成格式化的Bug报告文本。

4. 跨设备同步配置

把espanso的配置目录（~/.config/espanso/）放进Dropbox、iCloud或Git仓库，多台设备共享一套配置。换电脑时，安装espanso，把配置目录软链接过去，所有模板无缝迁移。

5. 搭配输入法使用

如果你用双拼或五笔，可以给espanso设置一个“安全触发符”，比如;;或@@，避免与输入法冲突。在default.yml里加：

search_shortcut: "ctrl+space"  # 修改触发快捷键

一些实用小贴士

• 不要贪多：一开始只配置5-10个最常用的模板，用两周后再逐步增加。配太多反而记不住触发词。
• 命名规范：触发词用英文冒号开头，后面跟有意义的缩写，比如:add代表地址，:ph代表电话。避免用单个字母（容易误触）。
• 版本控制：把配置放Git仓库里，每次修改后commit，可以回滚错误。
• 查看日志：如果espanso没反应，在终端运行espanso log看错误信息，大部分问题都是YAML格式错误。

和同类工具比，为什么选espanso？

市面上有TextExpander（付费）、aText（付费）、AutoHotkey（仅Windows）。espanso的优势在于：开源免费、跨平台统一体验、纯YAML配置（可版本控制）、活跃的社区和插件生态。如果你像我一样喜欢折腾，还可以自己写匹配规则，甚至通过Python扩展实现更复杂的逻辑。

最后提一句：espanso的官方文档写得相当清晰，遇到问题直接查，比看任何教程都管用。

---

好了，现在去下载espanso，把你每天重复输入的那些破事自动化掉吧。相信我，用上三天你就会后悔——为什么没早点知道这个工具。