Wox 搜索语法完全指南：修饰符、优先级与实战组合

语法的核心逻辑只有一句

Wox 的搜索语法本质上是在回答一个问题：把搜索范围从「所有东西」收窄到「我要的那一类」。每加一个修饰符，范围就窄一层。

理解这一点，你就不需要背语法表——只要知道「我想按什么维度筛」，然后找对应的修饰符即可。常见的维度只有五个：搜什么类型、在哪个位置、什么格式、什么时间、内容里有什么。

五个基础修饰符

这五个覆盖了绝大多数场景。如果只能记住两个，记 file: 和 folder:——它们解决的是「文件与目录同名时无法分辨」这个最常见的困扰。

用扩展名做格式筛选

扩展名不需要修饰符，直接写在关键词后面即可。它的作用是按文件类型收窄。

• 报价 xlsx —— 找所有报价相关的表格
• psd —— 列出全部设计源文件
• log —— 找日志文件
• 合同 docx pdf —— 同时匹配两种格式

扩展名筛选的实际价值在于「跳过无关项」。当你只记得文件内容不记得格式时，先按格式筛一遍往往比继续加关键词更快。

多个修饰符怎么叠加

叠加规则很简单：用空格分隔，条件是与的关系。每个修饰符各管一个维度，同时生效。

比如 file:合同 docx path:D 表示：文件名含「合同」、格式是 docx、位于 D 盘。三个条件同时满足才会出现在结果里。

关于顺序，从技术上讲修饰符的位置不影响结果，但从可读性讲有一个推荐写法：

1. 先写类型限制（file: 或 folder:）
2. 再写关键词
3. 最后写位置和格式限制

这样写的好处是，你在输入过程中就能看到范围逐步收窄，便于中途调整。

组合修饰符的四种实战句式

句式一：精确定位某个已知文件

file:年终总结 xlsx——当你知道文件名和格式，只差找到它在哪。这是最高频的一种。

句式二：在特定目录内检索

path:项目A 设计——当范围明确在某个大目录下，加 path: 能立刻排除掉全盘其他位置的干扰。

句式三：只找目录不找文件

folder:素材——当你想跳转到某个文件夹而不是打开文件时。配合方向键可以直接在资源管理器里定位。

句式四：程序与文件分清

app:ex——首字母搜索时，如果结果里混入了名为 ex 的文档，加 app: 明确只搜程序。

大小写与符号的处理

这些细节看起来琐碎，但直接影响「搜不到」时的判断：

• 英文关键词不区分大小写，输入 REPORT 和 report 结果一致
• 中文关键词没有分词限制，输入连续字符会做子串匹配
• 特殊符号需要谨慎，文件名里的引号、星号、问号可能与通配符语义冲突
• 空格是条件分隔符，不是文件名的一部分——文件名含空格时要分段输入关键词

修饰符与拼音的配合

中文场景下，修饰符最大的价值是让拼音首字母搜索变得可用。

纯首字母如 ht 命中范围很宽，可能返回几十条。加上 file: 之后能排除路径匹配的干扰，再加上扩展名能进一步收窄：file:ht docx 就已经相当精确了。

这个组合是中文文件检索的常规写法，建议直接记成一句：类型前缀 + 首字母 + 格式。

一张可以贴在桌边的速查表

• 想只找文件 → file:关键词
• 想只找目录 → folder:关键词
• 想只找程序 → app:关键词
• 想限定盘或目录 → 加 path:D 关键词
• 想限定格式 → 关键词后加扩展名
• 中文文件名 → 用拼音首字母，前面加 file:
• 什么都搜不到 → 先换个「一定存在」的片段验证索引

七条足够覆盖日常。剩下的修饰符，等真正遇到需求再查。

关于「学了不用」的建议

语法记不住是正常的，不必背。更有效的做法是把你每周都要做的检索写成三到五条固定句式，贴在便签上，用一周就形成肌肉记忆。

比如：file:周报 xlsx、path:Downloads exe、folder:项目、file:htmb docx。四条覆盖八成场景，剩下的靠临时查。

把语法当成工具箱而不是考卷——你不需要熟悉每一件工具，只需要在需要的时候知道去哪个盒子里拿。

语法学会之后容易退化的地方

一个常见现象：刚学会语法时用得很勤，一个月后不知不觉又回到「只输关键词、在结果里翻」。原因通常有两个。

一是没有把语法变成句式。零散的规则很难在需要时想起来，而固定句式可以。把「file: 加首字母加扩展名」当成一个整体记住，用的时候不假思索。

二是没有为语法付出过代价。如果从没因为缺少修饰符而浪费过时间，大脑就不会重视它。下次在几十条结果里翻找时，刻意停下来加一个 file: 再搜一次，这个对比会强化记忆。

保持语法的有效方式不是复习，而是让它成为默认动作——输入关键词的同时就自动带上类型前缀，不需要单独想起来。