Sublime Text如何排除文件夹不搜索_Sublime排除文件夹不搜索实战

Find in Files的Where输入框是搜索排除的真正入口

你是不是也遇到过这种情况：在Sublime Text里按下Ctrl+Shift+F（Mac上是Cmd+Shift+F）进行全局搜索，结果进度条慢得让人心焦，一看才发现，它正吭哧吭哧地扫描整个项目的node_modules或者dist目录？先别急着怀疑人生，这很可能不是你配置错了，而是压根没找对地方。

这里有个关键认知需要扭转：项目设置里的folder_exclude_patterns，其实管不着“查找文件”这个动作。它只负责让侧边栏看起来清爽，以及优化Ctrl+P这类功能的索引范围。真正决定搜索时扫哪些文件夹的“总开关”，藏在搜索面板右下角那个不起眼的Where输入框里。

Find in Files 的 Where 输入框才是搜索排除的真正入口

所以，正确操作姿势是这样的：打开搜索面板后，直接聚焦到Where输入框，在这里写下你的路径规则，修改立刻生效，所见即所得。

规则怎么写？其实很简单，但细节决定成败：

• 用.表示从当前项目根目录开始搜索（前提是你已经打开了文件夹或项目）。
• 想排除某个文件夹？用-号开头。比如-/node_modules/是排除根目录下的node_modules；而-*/node_modules/则更狠，会排除所有层级里叫这个名字的目录。
• 多个规则用英文逗号分隔，记住，逗号后面必须跟一个空格。标准写法是这样的：., -/dist/, -/build/, -*/__pycache__/。

当然，避坑指南也得备上。下面这些错误写法，会导致规则完全失效：

• -node_modules（缺少斜杠）
• -node_modules/（前面少了根目录标识/）
• ,-.git（逗号后面没加空格）

项目级配置 folder_exclude_patterns 必须写在 folders 数组内

如果你觉得每次搜索都要手动输入规则太麻烦，想一劳永逸，那就得靠项目配置文件.sublime-project了。不过，这东西结构要求相当严格，写错一点就可能完全不起作用。它可不是随便“加个字段”那么简单。

核心要点就两条：

1. 配置文件里必须包含一个"folders"数组，哪怕你的项目只关联了一个文件夹。
2. "folder_exclude_patterns"这个配置项，必须写在"folders"数组里的每个文件夹对象内部，绝对不能平级放在外层。

路径的写法也有讲究：

• 直接写文件夹名，不要斜杠。比如"node_modules"是对的，"node_modules/"就错了。
• Sublime Text不支持**/node_modules这种双星号递归语法，别这么写。
• 还有个容易踩的坑：如果你的"path"设置的是"src"，那么你想排除的node_modules如果在其父级目录，就得写成"../node_modules"才能匹配上。

说了这么多，来看一个正确的结构示例，一目了然：

{
  "folders": [
    {
      "path": ".",
      "folder_exclude_patterns": ["node_modules", ".git", "dist", "__pycache__"]
    }
  ]
}

全局设置不推荐，且只影响侧边栏和 Ctrl+P

可能有人会想，既然项目配置这么麻烦，那我直接在Preferences → Settings（用户设置）里加个全局的"folder_exclude_patterns"不就完了？省心。

这个想法很美好，但现实很骨感，而且极容易产生误解。全局设置对Find in Files搜索完全无效。它只管两件事：让侧边栏不显示某些文件夹，以及限制Go To Anything（就是Ctrl+P）的索引范围。

所以，不推荐全局排除像node_modules这样的目录。原因很简单：不同项目的依赖结构千差万别。你今天可能在做前端项目想排除它，明天可能就需要查阅某个Node.js库的源码。如果全局排除了，你在后一个项目里会死活“搜不到”相关代码，可能还会误以为是代码本身的问题。

如果真想设置一些全局过滤，建议仅限于.git、.DS_Store、*.log这类几乎所有项目都无关的通用项。

binary_file_patterns 和 file_exclude_patterns 别混用

最后，再来理清两个容易混淆的配置项：file_exclude_patterns和binary_file_patterns。它们分工明确，可别用错了地方。

• file_exclude_patterns：它的职责是控制哪些文件不显示在侧边栏*.log日志文件或者*.tmp临时文件，就加到这里。但要注意，如果手滑把*.json也加进去了，那你的配置文件可能在侧边栏就“消失”了。
• binary_file_patterns：这个配置项更重要，它决定了哪些文件不参与文本搜索。因为二进制文件（比如.png, .exe）用文本方式去搜毫无意义，只会拖慢速度或者返回一堆乱码。如果你的项目里有自定义的二进制格式，比如.wasm或.bundle文件，记得手动把它们加进来。