当 espanso 在长替换字符串上出错时(以及如何修复)
发布: (2026年2月21日 GMT+8 21:09)
2 分钟阅读
原文: Dev.to
Source: Dev.to
TL;DR ☕
如果替换字符串超过 100 个字符却没有展开,请在 ~/.config/espanso/default.yml 中增大 clipboard_threshold。
问题描述
长度超过 100 字符的替换字符串在 Espanso 中可能会悄悄失效。
示例片段:
- trigger: ":some-long-snippet"
replace: "Dear passangers, we have good news and bad news. Good news is we are landing. Bad news is we are crash landing!"
当键入触发词时,什么也不会插入,有时会出现类似命令提示符的 UI。
产生原因
Espanso 的默认配置中包含一个 clipboard_threshold 设置(被注释掉):
# clipboard_threshold: 100
如果替换文本超过此阈值,Espanso 会在没有任何警告的情况下中止插入。
解决方法
-
打开配置文件:
nano ~/.config/espanso/default.yml -
取消注释(或添加)
clipboard_threshold行,并将其设置为更大的数值,例如 500:clipboard_threshold: 500 -
保存文件并重新加载 Espanso(或手动重启):
espanso restart
重新启动后,长文本替换即可正常工作。
其他说明
- 该问题并非平台特定;在 macOS、Linux 和 Windows 上都会出现。
- 想快速了解 Espanso,请参阅文章 “Espanso: Because Who Actually Likes Typing Out Their Emails?” (链接占位符)。
祝使用愉快,扩展顺利!