regex-search 插件仅支持当前文件正则搜索，不支持跨文件全局搜索；项目级搜索由 atom 内置 find-and-replace 包处理，不兼容 pcre 特性如 k。
Regex-Search 插件不支持跨文件全局搜索
直接说结论：regex-search 插件只支持在**当前打开的文件中**进行正则搜索，它没有项目级（project-wide）搜索能力。你如果在 Atom 的「Find in Project」面板里输入正则并勾选「Regular Expression」，用的是 Atom 自带的搜索逻辑，和 regex-search 无关。
常见错误现象是：装了 regex-search 后，在项目搜索框里写 functions+(w+)s*()，结果匹配不到任何内容——不是正则写错了，而是这个插件根本没参与这次搜索。
- 插件核心功能是增强「当前编辑器」的查找体验，比如高亮所有匹配、支持
K重置匹配起点、可分组捕获后单独替换 - 项目搜索走的是 Atom 内置的
find-and-replace包，其正则引擎基于 JavaScript（V8），不支持 PCRE 特性（如K、(? 等） - 如果你需要在项目中跑复杂正则，得换思路：要么降级正则表达式适配 JS 引擎，要么导出文件用外部工具（如
ripgrep）处理
在项目搜索中写 JS 兼容的正则表达式
Atom 的「Find in Project」使用的是 JavaScript RegExp，所以必须遵守它的语法限制。例如，不能用 K，不能用 (?（JS 旧版本不支持 lookbehind），也不能用 <code>Q...E。
典型场景：你想找所有以 export default 开头、后面跟着函数声明的模块入口。
- ❌ 错误写法（PCRE 风格）：
export defaults+(function|class)s+(w+)s*(?={)——(?={)虽然现代 JS 支持，但 Atom 某些版本会因转义问题报Invalid regular expression - ✅ 可靠写法：
export defaults+(function|class)s+(w+)s*{，然后手动确认是否为块级结构 - 注意转义：路径中的反斜杠要写成
\\（因为 Atom 配置层 + 正则层各吃一层），而字面量{、}在字符类外无需转义，但放在末尾易被误判，建议加s*缓冲 - 性能提示：避免
.*开头的贪婪匹配，项目搜索时会显著变慢；用[^}]*或[^ ]*局部限定更稳
用 regex-search 做单文件深度分析再扩散到项目
当正则太复杂、无法塞进项目搜索框时，可以先用 regex-search 在关键文件里验证逻辑，再把简化后的模式用于全局搜索。
例如：你想定位所有未被 useEffect 包裹的 setState 调用，且排除注释行。
- 在某个 .jsx 文件中打开
regex-search面板，输入：^(?!.*//).*setStates*()—— 它能正确跳过注释行（regex-search支持多行模式和更准的行首锚定） - 确认匹配准确后，把正则“降级”为项目可用版：
setStates*()，再配合「Exclude VCS Ignored Paths」和文件类型过滤（*.jsx,*.js）缩小范围 - 插件的
Replace All in Buffer功能支持用$1引用捕获组，但项目 Replace 不支持该语法，这点务必提前测试
真正需要复杂正则时，绕过 Atom 直接调命令行
Atom 的 UI 搜索本质是封装，遇到边界情况（如 Unicode 字符类、嵌套括号、超长上下文匹配），不如用原生工具可靠。
推荐组合：ripgrep（rg）+ Atom 的「Terminal」或外部终端：
- 安装
rg后，在项目根目录运行：rg -n '(?:const|let|var)s+(w+)s*=s*function' --glob '*.js' - Atom 中按
Ctrl+Shift+T打开内置终端，粘贴命令即可；结果点击行号能跳转到对应文件位置 -
rg默认支持 PCRE2 子集（如-P启用 Perl 模式），比 JS 正则强得多；且速度远快于 Atom 内置搜索 - 注意：Atom 的「Find in Project」不读取
.gitignore外的忽略规则，而rg默认尊重所有忽略文件，一致性更高
真正容易被忽略的是：Atom 搜索框里的「Case Sensitive」和「Whole Word」开关，会影响正则语义——比如开启「Whole Word」后，foo 就多余了，反而可能漏匹配。调试时建议先关掉这些辅助选项，确认正则本体行为。
