ES.exe 使用指南:把 Everything 接进脚本与批处理
ES.exe 是 voidtools 官方维护的独立程序,用来在命令提示符或 PowerShell 里调用 Everything 的索引,把结果输出成文本、CSV 或 JSON。它让 Everything 从一个窗口工具变成可以被脚本调用的检索组件,这是 Everything 命令行真正的价值。
一、安装与运行前提
ES.exe 不在 Everything 的安装包里,需要从官方下载页或 GitHub 的 voidtools/ES 仓库单独获取。官方建议把 es.exe 解压到 %LOCALAPPDATA%\Microsoft\WindowsApps,这个路径已经在系统的 PATH 里,放进去之后在任意目录都能直接调用 es 命令。
运行前提是 Everything 主程序已经在运行——ES 本身不建索引,它通过 IPC 向 Everything 索取结果。所以脚本里如果需要无人值守执行,要么保证 Everything 常驻,要么先启动它再调用 ES。
基本语法是 es.exe [选项] 搜索文本,搜索文本沿用 Everything 的搜索语法,因此 ext:、size:、dm:、dupe: 这些函数在命令行里同样可用。
二、五组常用参数
限制结果数量与偏移:-n / -o
-n 50 只输出前 50 条,不写的话大量结果会刷满屏幕。配合 -o 50 可以从第 51 条开始取,实现分页导出。做清单类脚本时,先加 -n 试跑,确认条件正确后再放开数量。
限定搜索范围:-path / /ad / /a-d
-path D:\Logs 把搜索限定在该目录及其子目录;/ad 只返回文件夹,/a-d 只返回文件。审计目录结构时用 /ad,统计文件时用 /a-d,能避免两类结果混在一起还要二次过滤。
控制匹配方式:-r / -i / -p / -w
-r 启用正则,-i 区分大小写,-p 匹配完整路径而不只是文件名,-w 只匹配整词。四个开关默认全部关闭,这也是很多人第一次用 ES 觉得“结果太多”的原因——默认匹配比图形界面更宽松。
排序与输出格式:-sort / -csv / -json
-sort size -sort-descending 按大小倒序,支持 name、path、size、extension、date-modified 等字段。-csv、-json、-tsv、-efu 切换输出格式,CSV 适合丢进表格,JSON 适合交给程序解析,EFU 可以回灌到 Everything 当文件列表用。
导出到文件:-export-csv / -no-header
-export-csv out.csv 直接写文件,比用重定向更稳妥,不会因编码问题产生乱码。加 -no-header 去掉表头,方便与已有文件拼接;加 -utf8-bom 可以让 Excel 正确识别中文。
三、两个能直接用的示例
每日盘点日志文件:es.exe -path D:\Logs -p "*.log" -sort date-modified -sort-descending -n 100 -export-csv D:\Logs\recent.csv。这条命令把最近修改的 100 个日志导出成表,丢给运维做例行检查。
清理超过半年的安装包:先用 es.exe -path D:\Downloads ext:exe;msi size:>50mb -csv 在屏幕上核对结果,确认无误后再把 -csv 换成 -export-csv,把清单交给删除脚本处理。先看后删是命令行操作必须养成的习惯。
需要注意,命令行输出的编码跟随系统区域设置。如果脚本在其它机器上运行出现中文乱码,优先加 -utf8-bom,而不是改代码页。
三·补充:结果怎么接给下一步
ES 的输出是纯文本,这意味着它可以被任何工具消费。最省事的接法是导出 CSV 后用表格软件筛选,需要程序处理时用 -json;如果下一步是删除或移动,建议让 ES 只输出路径列,再用 -double-quote 给路径加引号,避免文件名里的空格把参数截断。
另一个常见需求是判断“有没有结果”。ES 在有匹配时返回 0、无匹配时返回非零值,脚本里可以直接用返回值做分支,不必解析输出文本。这一点在写计划任务时很实用:没有新文件就不继续执行后续步骤。
四、适用人群
ES.exe 面向三类人:需要把文件清单纳入日常报表的运维与行政;写构建脚本、需要按扩展名批量收集产物的开发者;以及想给 Everything 做二次封装的效率工具玩家。
如果你只是偶尔找文件,图形界面已经足够,不必引入命令行。命令行带来的收益集中在可重复与可自动化——同样的查询写成一行命令,就能交给计划任务定时跑,这是窗口工具做不到的。
五、下载与安装
ES.exe 与 Everything 主程序分开下载,版本号独立(当前为 1.x 系列)。下载后只解压一个 exe,不写注册表,卸载直接删除即可。主程序仍建议使用稳定版 1.4.1.1032,安装包约 2MB。
部分进阶参数(如索引日志 journal 相关选项)要求 Everything 1.5 及以上版本,用 1.4 时这些参数会被忽略。混用版本排查问题时,先确认主程序版本,再看参数说明,能少走弯路。