binary_file_patterns是Sublime Text控制二进制文件是否被搜索的唯一开关,它直接跳过匹配扩展名的文件IO,不读取内容,与路径排除设置无关,修改后需重启Find in Files面板。

binary_file_patterns 是控制二进制文件是否被搜索的唯一开关
Sublime Text 默认会跳过 binary_file_patterns 列表里的所有文件扩展名,哪怕它们其实是纯文本(比如误命名为 .wasm 的配置文件),也不会读取内容。这不是“忽略”或“过滤”,而是直接跳过文件 IO——所以搜不到,也不卡,但结果就少了。
它和 folder_exclude_patterns、file_exclude_patterns 完全无关:后两者管路径和文件名,这个管文件类型判断逻辑。
-
binary_file_patterns必须写在Preferences → Settings – User或.sublime-project的folders对象内才生效 - 值是字符串数组,支持通配符
*,不支持正则:"*.png"✅,"*.png|*.jpg"❌ - 默认值包含
"*.png"、"*.zip"、"*.exe"等;如果你项目里有.gql、.schema这类自定义文本格式,又没从列表里删掉,就会被静默跳过 - 改完设置后,**必须关闭并重开 Find in Files 面板**(按
Esc再按Ctrl+Shift+F),否则旧缓存仍起作用
怎么确认某个文件被当成二进制而跳过了
最直接的方法:打开那个疑似被跳过的文件,看 Sublime 窗口右下角状态栏是否显示 Binary。如果是,说明它已被 binary_file_patterns 拦截,不会参与任何搜索。
炫酷的jQuery二进制数字时钟,它的时分秒都是用二进制来表示,绿色表示该位值是1,灰色则表示0,原理是将时钟的时分秒分别实时转换成二进制,然后随着本地时间的更新而实时刷新
- 右下角显示
UTF-8或Plain Text→ 正常可搜 - 显示
Binary→ 被binary_file_patterns匹配中,需检查配置 - 显示
Invalid start byte→ 文件可能含 BOM 或非 UTF-8 字节,不是binary_file_patterns问题,而是编码识别失败
清空 binary_file_patterns 后搜索变慢?这是预期行为
清空 "binary_file_patterns": [] 后,Sublime 会尝试读取所有文件的内容(包括图片、压缩包、字体等),这会导致:
- 搜索明显变慢,尤其当项目里有大量
.jpg、.zip文件时 - 某些文件因无法解码(如含
\x00)报错,面板底部弹出 “Error loading file”,但不影响其余文件搜索 - 真正该清空的场景:你明确知道某些扩展名是文本,但被默认规则误伤了;而不是“为了保险全清空”
- 更稳妥的做法是只移除确定为文本的扩展名:
"*.gql"、"*.graphql"、"*.proto",保留"*.png"、"*.pdf"等无关项
Where 输入框和 binary_file_patterns 的关系
Where 输入框(如 ., -/node_modules/)只控制目录路径,对文件类型无影响。即使你用 Where 排除了整个 dist/ 目录,只要里面有个 dist/app.wasm 被 binary_file_patterns 列表覆盖,它还是会被跳过——但因为目录已排除,这条规则实际没机会触发。
也就是说:
-
Where优先级更高:先按路径筛选,再按binary_file_patterns判断剩余文件 - 二者不冲突,但别指望
Where能绕过binary_file_patterns的限制 - 如果搜索漏结果,先查右下角状态栏是否为
Binary,再查Where是否写错格式,最后看folder_exclude_patterns是否误伤了路径

















