Atom全局搜索“漏文件”是因为默认仅搜索首个显式添加的项目路径，且受File/directory pattern非空、Only in open files勾选、.gitignore与core.ignoredNames双重过滤影响。
全局搜索范围为什么总“漏文件”
Atom 的 Ctrl+Shift+F（macOS 为 Cmd+Shift+F）默认不扫整个项目根目录，而是只在你通过 Add Project Folder 显式添加的第一个路径下运行。搜不到文件，大概率不是 Atom 坏了，而是范围被悄悄收窄了：
-
File/directory pattern输入框非空（比如残留src/**/*.ts或!node_modules），就会跳过其他路径或后缀——必须留空才能全量扫描 -
Only in open files若被勾选，哪怕项目里有 200 个文件，也只搜当前已打开的 tab —— 这是批量重构时最常误触的开关 - 搜索结果还会受
.gitignore和 Atom 的core.ignoredNames双重过滤，node_modules、dist/这类路径默认被跳过，不是没扫到，是主动忽略
正则替换写对了却没生效？先看这个开关
Atom 默认把查找输入当纯文本处理，哪怕你写了 \d+ 或 function\s+(\w+)，也不会识别为正则——除非点亮右下角的 .* 图标（或按 Alt+R）。80% 的“正则不工作”问题出在这儿：
- macOS 用户注意：
Cmd+Alt+F是快捷键切换 regex 模式，不是Cmd+Shift+F - 捕获组引用必须用
$1、$2……最多到$9；写\1不报错，但会原样输出字面量\1 -
.默认不匹配换行符，所以start.*end在多行文本里必然失效；要跨行，得显式写start[\s\S]*?end（[\s\S]显式覆盖所有字符，包括换行）
Replace All 是直写磁盘的，没有预览也没有撤回
Replace All 一旦点击，所有匹配位置立即变更，Ctrl+Z 只能撤回当前文件的改动，其他文件已永久修改。这是最容易酿成事故的一环：
- 务必先点
Find All，看右侧结果面板列出的文件数和行数是否合理 - 涉及函数重命名等重构操作，建议分两步：先用
Find in project定位全部候选位置，再手动打开几处关键文件，用Ctrl+F+Replace逐个确认上下文 - 大项目慎用
Replace All，尤其当File/directory pattern或Only in open files状态不明时
底层用的是 ripgrep，但不是全自动启用
Atom 底层搜索引擎是 ripgrep（rg），但它需要手动开启支持，否则 fallback 到慢得多的 scandal 实现：
- 进
Settings > Packages，搜find-and-replace，确认状态为 “Enabled” - 点开该包设置页，检查
Use ripgrep是否勾选（旧版叫Enable ripgrep support） - 终端执行
rg --version看系统是否装有ripgrep；未安装时 Atom 不会自动装，只会降级使用 scandal
真正麻烦的不是语法记不住，而是三个隐性开关（pattern、only in open files、project root）和两个默认过滤（.gitignore、core.ignoredNames）同时生效，稍不留神就改漏或改错。动手前花十秒核对这些状态，比事后抢救快得多。
