ueli 自定义网页搜索完全指南：3 步配置你的专属搜索前缀

ueli 自定义网页搜索完全指南：3 步配置你的专属搜索前缀

【免费下载链接】ueliCross-Platform Keystroke Launcher项目地址: https://gitcode.com/gh_mirrors/ue/ueli

ueli 自定义网页搜索（Custom Web Search 扩展）帮你解决一个日常小烦恼：在多个网站之间搜索时，要反复切标签页、找搜索框、敲地址。用这个功能，你只需在 ueli 里敲一个短前缀，回车就直接在浏览器里打开对应网站的搜索结果。读完本文，你可以给自己常用网站各配一个"搜索暗号"，比如敲wiki搜维基百科、敲gh搜 GitHub。

什么是 ueli 自定义网页搜索？

一句话：它是给浏览器装的"频道遥控器"。

你把它想象成机顶盒遥控器——按不同数字键就换不同频道。在 ueli 的搜索框里，wiki、gh、zs这些短词就是"频道号"：以哪个词开头，ueli 就把你后面输入的内容送进对应网站的搜索框。不用打开浏览器、不用找地址栏，打字、回车、直达结果页。

这个扩展同时支持 Windows、macOS 和 Linux。

快速上手：3 步跑通 ueli 自定义搜索引擎配置

第 1 步：打开设置窗口

启动 ueli 后，用它的设置入口（托盘图标菜单或命令）打开设置窗口。

第 2 步：启用扩展并添加第一个搜索引擎

在扩展列表里找到Custom Web Search（自定义网页搜索），进入它的设置页，点击"添加搜索引擎"，填入四个字段（下一节详解）。保存即可。系统自带一个默认示例：前缀wiki，指向维基百科。

第 3 步：按快捷键，输入前缀，回车

按下你给 ueli 绑定的全局快捷键呼出搜索框，输入wiki 机器学习，回车——浏览器直接打开维基百科的搜索结果。

核心配置详解：4 个字段怎么填

新增一个搜索引擎只需 4 个字段，逐个说清楚：

一个最小可用的配置示例：

{ "name": "学术搜索", "prefix": "gs", "url": "https://scholar.google.com/scholar?q={{query}}", "encodeSearchTerm": true }

几点提醒：

• 前缀是"开头匹配"：只有当你输入的第一个字符就是前缀时才会触发，写在中间不行。
• {{query}}区分大小写：少写一个花括号或写成{query}，模板会校验不通过、保存不了。
• 每个搜索引擎的图标由 ueli 自动抓取该网站域名下的图标，不用额外配置。

进阶技巧：3 个提效用法

1. 高频网站用最短前缀

最常用的一两个网站，前缀可以只给 2 个字母，甚至 1 个。比如g对应 Google、z对应知乎搜索。手指离键盘键位近的字母优先，效率差距一天下来很明显。

2. 模板不只是"搜索"，还可以当"直达快捷方式"

URL 模板里{{query}}不是必须语义化的搜索框。你可以把任意固定页面配成模板，例如把内部门户、GitHub 的某个仓库搜索页直接"暗号化"，敲一下前缀就跳过去。

3. 全局快捷键 + 前缀，组成单手工作流

给 ueli 绑一个顺手的快捷键（比如Alt+Space），流程变成：按快捷键 → 敲前缀 → 空格 → 敲关键词 → 回车。全程不碰鼠标，比"打开浏览器→找标签页→找搜索框"快得多。

常见问题与避坑

触发词不生效，搜不出来？

按顺序查三处：① 前缀是否写在输入最开头；② URL 模板里有没有完整的双花括号{{query}}；③ 前缀是否真的保存成功（设置页的列表里能看到）。

带空格或特殊字符的搜索词打开报错？

把"编码搜索词"打开。编码后空格会变成%20，绝大多数网站都能正常处理；关掉编码时空格原样拼进 URL，部分网站会直接解析失败。

提示"前缀已被占用"？

同一个前缀只能属于一个搜索引擎，系统会直接拦住你重复使用。换个更独特的组合即可，这也反向提醒前缀别起太随意。

跟着旧教程找不到"添加搜索引擎"入口？

早期版本的 ueli 把自定义搜索引擎放在应用设置里，9.x 大版本做模块化重构后，这个能力被独立成了 Custom Web Search 扩展——入口搬到了扩展设置页，老教程里的路径已经失效，按本文第 2 步走就行。

写在最后

ueli 自定义网页搜索的价值就一句话：把"打开浏览器再搜"压缩成"敲个前缀回车"。配置一次，天天受益。想看得更细，可以翻翻官方文档：docs/Extensions/CustomWebSearch/README.md。

【免费下载链接】ueliCross-Platform Keystroke Launcher项目地址: https://gitcode.com/gh_mirrors/ue/ueli