ctrl+shift+f（windows/linux）或cmd+shift+f（macos）是atom唯一真正的跨文件全局搜索入口；必须添加完整项目根目录、开启正则开关（右下角.*图标）、确认ripgrep启用，否则搜索不全或极慢。
Ctrl+Shift+F 是唯一能跨文件全局搜索的入口
Atom 没有“右键项目名→全局搜索”这种功能，所谓“Search Directory”右键菜单只扫当前一级目录，不递归子目录。真正全项目扫描必须用快捷键：Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）。
常见错误现象：点了右键以为搜全了，结果 src/utils 里的文件根本没被扫到。
- 必须先通过 File > Add Project Folder 把完整项目根目录加进项目窗格；只打开几个文件不算“项目”
- 面板左上角显示的路径必须是你预期的根目录，比如
/home/user/myapp，而不是某个子文件夹 - 如果加了多个路径，Atom 默认以第一个为基准，想限定范围得手动在
File/directory pattern框里输src/**
正则模式不点亮，写啥都是纯文本匹配
查找面板右下角那个 .* 图标就是正则开关，它不亮，\d+、console\.log\([^)]+\) 全部按字面处理——这是 80% 的“搜不到”问题根源。
macOS 用户别依赖 Cmd+Alt+F 切换，键盘冲突高发，每次打开都手动点一次最稳。
- 开启后才能用
^、$、\s、(foo|bar)等语法 -
.默认不匹配换行符，跨行要写[\s\S]*?或[^]*?，不是.*加标志位（Atom 不支持/s或/m） - 捕获组引用必须用
$1、$2，\1会被当普通字符输出
批量替换前务必确认三个隐性过滤器
Replace All 是真·无预览、无分步确认、无跨文件撤销的操作。点下去那一刻，所有匹配位置立即永久修改，Ctrl+Z 只能撤回当前文件，其他文件已不可逆。
-
File/directory pattern输入框默认是**，但如果误填成*.ts或lib/**，就会漏掉其他后缀或目录 -
Only in open files勾选项一旦启用，哪怕你加了整个项目，也只改当前已打开的 tab —— 这是批量重构时最常踩的坑 - 搜索还受
.gitignore和 Atom 的core.ignoredNames双重过滤，比如node_modules默认被跳过，改配置也无效
ripgrep 没启用，搜索就慢得反人类
Atom 自 1.24 起默认集成 ripgrep（rg），但这个加速引擎可能被禁用或退回到慢速的 Node.js 实现。
检查方法：进 Settings > Packages，搜 find-and-replace，确保已启用；再开开发者工具（Ctrl+Shift+I），执行 atom.packages.isPackageActive('find-and-replace') 应返回 true。
如果你在大型项目里等搜索结果超过 2 秒，第一反应不该是忍，而是去确认这个包有没有真在跑。
