Atom 的 fuzzy-finder 不支持正则表达式，因其设计目标是人眼直觉匹配，依赖分词与权重打分，所有输入（如 ^api.*.ts$）均作字面量处理；精准筛选应使用 Find in Project 的 Unix shell 通配符或终端命令。
首先需要明确一个核心要点：Atom 编辑器内置的 fuzzy-finder 插件，并不支持使用正则表达式来搜索和匹配文件名。 如果你尝试输入类似 ^api.*\.ts$ 这样的正则模式，希望它能精确查找以“api”开头、以“.ts”结尾的文件，结果往往会落空。这是因为其底层算法并非基于正则引擎解析，而是采用了完全不同的字符串模糊匹配与权重评分机制。
为什么 fuzzy-finder 无法识别正则表达式？
这源于其根本的设计哲学。fuzzy-finder 旨在模拟“人脑的模糊联想与快速定位”，核心追求是智能容错与直觉匹配。例如，当你输入 usrctrl 时，它能高效地为你推荐 user-controller.js 这个文件。实现这一效果的关键在于，插件会将输入字符串和候选文件名按常见分隔符（如短横线、下划线、点号、大小写变化处）进行智能分词，然后计算这些“词块”的匹配度、连续性和位置权重，而非去解析正则语法中的特殊字符。
因此，对于 fuzzy-finder 而言：
- 你输入的所有字符，包括
.*、^、$、[]等，都会被视作普通的文本字符进行字面匹配。 - 搜索默认不区分大小写，但如果你输入了大小写混合的字符（例如
ApiH），则会提升像api-handler.ts这类符合大小写变化模式文件的排序权重。 - 分隔符甚至会影响匹配得分：输入
apih有时比输入apihandler更容易优先匹配到api-handler.ts，因为前者更贴合分词后的“api”和“h”两个片段。
简而言之，fuzzy-finder 更像一个善解人意的智能助手，擅长根据模糊输入猜测你的意图，而非一个严格按规则行事的命令行工具。
精准筛选的替代方案：使用 Find in Project 功能
那么，当我们需要根据特定规则精确筛选文件名时，应该如何操作？正确的路径是使用 Atom 的「在项目中查找」（Find in Project）功能。
通过快捷键 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）打开搜索面板，注意面板底部的 File/Directory pattern（文件/目录模式）输入框。在这里，你可以使用 Unix shell 风格的通配符（Glob Patterns）来限定搜索的文件范围：
- 仅搜索所有 TypeScript 文件？输入
**/*.ts。 - 需要排除所有测试文件？可以写成
!**/*.test.ts。 - 只想查找
src/api目录下，且文件名包含service的 TS 文件？模式src/api/**/*service*.ts即可实现。
使用此功能时需注意几个关键细节：排除符号 ! 必须写在模式开头且顶格，前面不能有空格，否则排除规则无效；而 ** 表示匹配任意层级的子目录。需要注意的是，此字段不支持 \d+ 或 [a-z] 这类正则字符集，但通过 ?（匹配单个字符）、*（匹配零个或多个字符）和 **（跨目录递归匹配）的组合，已能覆盖绝大多数文件筛选场景。
Atom 文件搜索中容易被忽略的配置与陷阱
然而，即使通配符模式写对了，有时也可能搜索不到预期的文件。一个常见的原因是 Atom 的默认配置：它会自动遵循项目根目录下 .gitignore 文件的规则。如果你的 dist/、build/、node_modules/ 等目录被列入了忽略列表，那么即使其中存在匹配的 .ts 文件，默认也不会被纳入搜索范围。
解决此问题有两种方法：
- 进入 Atom 的
设置（Settings）→ 核心设置（Core）→ 排除版本控制忽略的路径（Exclude VCS Ignored Paths），关闭此选项。 - 或者，直接在
File/Directory pattern中手动将这些目录加入白名单，例如dist/**/*.ts（前提是该路径没有被上层的!排除规则所阻挡）。
此外，还有一个细节值得注意：在 Atom 的多项目工作区（Project with Multiple Folders）环境下，File/Directory pattern 默认仅对当前激活的单个项目文件夹生效。除非你特意勾选了搜索面板右上角齿轮菜单中的 Search in all project folders（在所有项目文件夹中搜索）选项。
最后需要指出，当你需要进行极其复杂、正则表达式级别的文件名筛选时，或许不必局限于编辑器内部。一个更强大、更灵活的做法是直接调用系统终端，使用如 find、grep 或 rg (ripgrep) 等命令行工具进行组合查询，例如 rg --files | grep -E 'api.*service.*\.ts'。毕竟，Atom 的 fuzzy-finder 本质上是一个为提升日常编码中文件跳转效率而优化的辅助工具，并非一个全功能的文件系统查询引擎。理解其设计定位，才能在不同场景下选择最高效的解决方案。
