atom全局搜索需检查三处开关：file/directory pattern留空、取消only in open files勾选、确认项目路径添加顺序；正则替换用$1而非\1，需点亮.*图标；启用ripgrep并验证系统安装；批量替换前务必预览作用域。
Atom 的全局搜索不是“打开项目就能随便搜”，它默认只扫你 Add Project Folder 进来的路径，且受三处隐性开关控制：右上角的 File/directory pattern、右下角的 Only in open files 勾选项、以及项目根目录的选取顺序。漏掉任意一个，就可能搜不到关键文件。
Ctrl+Shift+F 搜不到整个项目？先看这三处开关
很多人按 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）后，在面板里输关键词却没结果，实际是范围被悄悄收窄了：
-
File/directory pattern输入框非空（比如误填了src/**/*.ts或!node_modules），就会跳过其他路径或后缀——留空才全扫 -
Only in open files若被勾选，哪怕你项目里有 200 个文件，也只搜当前已打开的 tab 页——这是批量重构时最常误触的开关 - 你通过
Add Project Folder加了多个路径，Atom 默认以第一个为基准；想限定到某子目录，得手动在 pattern 框里写folder1/**，而不是指望它自动识别
正则替换写对了却没效果？大概率是引用语法或跨行问题
Atom 用的是 JavaScript 正则引擎，不是 sed 或 Python 风格，\1 在替换框里不会还原捕获内容，只会原样输出反斜杠加数字。
- 捕获组必须用
$1、$2……最多到$9；$0表示整个匹配内容 -
.默认不匹配换行符，所以start.*end在多行文本里会失效；得显式写start[\w\W]*?end（[\s\S]在部分 Atom 版本中解析异常，不推荐） - 右下角那个
.*图标必须点亮——80% 的“正则不工作”问题卡在这一步；macOS 用户可用Cmd+Alt+F快速切换
搜索慢？别硬等，先确认 ripgrep 是否真在跑
Atom 自带的 find-and-replace 包底层已集成 ripgrep（rg），但这个加速开关不是全自动的。万级文件项目中，ripgrep 通常 1–2 秒出结果，而退化到 Node.js 实现的 scandal 可能卡顿 10 秒以上。
- 进
Settings > Packages，搜find-and-replace，确保状态为 “Enabled” - 点开该包设置页，检查
Use ripgrep（旧版叫Enable ripgrep support）是否勾选 - 终端执行
rg --version看系统是否装有ripgrep；Atom 会优先调用系统版，未安装时 fallback 到内置二进制 - 临时禁用其他搜索类插件（如
advanced-open-file、project-find-plus），避免冲突
批量替换前不验证作用域，Ctrl+Z 也救不回来
Replace All 是真·无预览、无分步确认、无跨文件撤销历史。一次点下去，所有匹配位置立即变更，Ctrl+Z 只能撤回当前文件的改动，其他文件已永久修改。
- 涉及函数重命名、API 路径变更等重构操作，建议先关掉
Only in open files，清空File/directory pattern，再手动点开几处搜索结果验证上下文 - 对大型项目，宁可分两次：第一次用
Find in project定位所有候选位置，第二次打开关键文件用Ctrl+F+Replace逐个确认 - 别依赖
Find All后直接打字——方向键、滚动、点击空白处、触发自动补全都会瞬间清空所有多光标
最容易被忽略的其实是 core.excludeVcsIgnoredPaths 和 find-and-replace.preserveCase 这两个配置项，它们不出现在搜索面板上，却直接影响是否跳过 .gitignore 里的目录、以及大小写敏感行为。改之前最好先在 Settings > Core 和 Settings > Packages > find-and-replace 里扫一眼当前值。
