<p>项目级搜索必须用 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS），因 Ctrl+F 仅限当前文件；Find in Project 基于 ripgrep，支持 .gitignore 过滤、正则需点 .* 按钮启用、替换用 $1、跨行匹配需 (?s) 或 [\w\W]。</p>
项目级搜索必须用 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS），不是 Ctrl+F；否则永远只在当前文件里找，根本扫不到整个项目。
为什么 Ctrl+F 找不到项目里的内容？
这是最常踩的坑：按 Ctrl+F 弹出的是「Find in Current Buffer」，只搜当前打开的文件。哪怕你开了 20 个文件，它也只盯住焦点所在的那一个。项目全局搜索是独立功能，快捷键必须是 Ctrl+Shift+F（或 Cmd+Shift+F），它调起的是「Find in Project」面板，底层走 ripgrep 引擎——快、准、支持 .gitignore 自动过滤。
常见错误现象：
- 右键项目根目录 → 点 “Search Directory” → 结果只扫了那个子目录，漏掉
src/、lib/等路径 - 快捷键没反应 → 先检查
find-and-replace包是否启用（Settings > Packages > find-and-replace） - 搜不到某个文件 → 很可能被
.gitignore或core.ignoredNames过滤了，不是 Atom 没扫到
Find in Project 面板里正则怎么才生效？
Atom 默认把搜索框内容当纯文本处理，哪怕你写了 \d+ 或 function\s+(\w+)，也不会识别为正则——除非手动点开右下角的 .* 按钮（或按 Alt+R）。这一步漏掉，所有高级匹配都白写。
关键细节：
- 替换时捕获组必须用
$1，不是\1（JavaScript 风格） - 跨行匹配不能靠
.*，得用[\w\W]或开头加(?s)（单行模式） - 大小写敏感默认关闭，搜
HTTP会漏掉http，需点Aa按钮开启 - 路径过滤填
!node_modules可手动排除，但.gitignore里已有的目录默认就被跳过
为什么模糊搜文件（Cmd+T）有时没结果？
fuzzy-finder 默认只索引“已添加为项目根目录”的文件，不是编辑器里所有打开的标签页。如果你只是双击打开了几个 JS 文件，没通过 File > Add Project Folder 添加整个文件夹，Cmd+T 就搜不到它们。
其他限制：
- 搜
userctrl能命中user-controller.js，但连字符、下划线、点号会被当作分隔符参与权重计算 - 想直跳某行：输
api.ts:42（中间不能有空格），但仅对已保存、已索引的文件有效 - 过滤噪音文件需改
core.ignoredNames，填"node_modules", "*.log", "dist/"，改完必须重启 Atom - 开了多项目工作区（比如同时加了
frontend和backend），要手动勾选面板右上角齿轮里的Search in all project folders，否则只搜第一个
搜索变慢或结果不准，优先检查这三处
性能问题往往不出在语法，而在配置和范围控制：
- 确认
find-and-replace包设置了Use ripgrep（不是 fallback 到 scandal）；终端执行rg --version可验证系统是否装有ripgrep - 关掉
find-and-replace.showResultsAsSymbols（这个选项会让 Atom 尝试解析符号结构，对纯文本项目纯属拖累） - 避免在搜索框里输中文路径或带空格的目录名——
ripgrep对 shell 解析敏感，容易报error: unrecognized option，换成英文路径或加引号更稳
真正影响行为的配置项其实就几个：core.excludeVcsIgnoredPaths、find-and-replace.useRegex、find-and-replace.preserveCase，全在 Settings 里可点选，别去改 config.cson 或插件源码——那些是给插件作者看的内部接口，普通用户改了不仅无效，还可能被下次更新覆盖。
