Atom全局搜索需手动添加项目路径，并受.gitignore、core.ignoredNames和File/directory pattern三重过滤；正则需点亮.*按钮；Replace All后须手动Save All；默认启用ripgrep但可能回退至慢速scandal。
Atom 的全局搜索不是“输完回车就出结果”，它默认只扫你手动添加的项目路径，且受 .gitignore、core.ignoredNames 和面板右上角的 File/directory pattern 三重过滤——漏掉其中任意一个，就可能搜不到关键文件。
Ctrl+Shift+F 搜不到文件？先确认这三处隐性开关
Atom 的 Find in Project 不会自动扫描整个磁盘，也不会遍历所有已打开的 tab。它只作用于你通过 File > Add Project Folder 显式添加的路径（以第一个为准），并默认跳过被 .gitignore 或 Atom 内置 core.ignoredNames 排除的目录（如 node_modules、dist）。
常见错误现象包括：搜 api.ts 却没结果；搜到部分文件但漏掉 types/ 下同名逻辑；右键项目根目录点 Search Directory 只扫了子目录。
- 右上角
File/directory pattern输入框必须留空，才扫描所有后缀；填了src/**或*.js就会主动过滤其他范围 - 右下角
Only in open files勾选项一旦启用，哪怕你开了 50 个文件，也只搜当前 tab —— 这是批量改错最常误开的开关 - 多项目工作区（如同时加了
frontend和backend）需手动勾选齿轮图标里的Search in all project folders，否则只搜第一个
正则匹配写了却没效果？80% 是没点亮 .* 按钮
Atom 默认把搜索框内容当纯文本处理。\d+、function\s+(\w+) 这类写法，不点右下角 .* 图标或不按 Alt+R（Windows/Linux）/Cmd+Alt+F（macOS），就完全不会触发正则引擎。
更隐蔽的问题是跨行匹配：. 默认不匹配换行符，所以 start.*end 在多行文本里必然断在第一行末尾。
- 捕获组引用必须用
$1、$2……不能写\1，后者会被原样输出 - 要跨行匹配，得显式写
[\s\S]*?或更短的[^]*?；(?s)在 Atom 中可用，但/s或/m标志无效 -
.*图标必须点亮——这是“正则不工作”的首要排查点，尤其 macOS 用户容易和Cmd+Shift+F混淆
Replace All 后代码没变？可能是文件根本没保存
Atom 的 Replace All 会直接修改内存中的文件副本，但不会自动保存。如果被替换的文件没处于打开的 tab 中，标题栏不会显示 *，你也看不到它已被改动。
关编辑器时弹出“是否保存全部更改”，若漏勾或点了“Don’t Save”，所有批量结果就永久丢失。
- 执行前务必确认
Only in open files未勾选，且File/directory pattern为空 - 替换完成后立即执行
File > Save All（快捷键Ctrl+K S/Cmd+K S） - 对大型重构（如函数重命名），建议分两步：先用
Find in Project查看右侧结果面板的文件数与行数是否合理，再人工点开几处验证上下文后再批量
搜索慢得像卡死？优先检查 ripgrep 是否真在跑
Atom 自 1.24 起默认集成 ripgrep（rg），但这个功能可能被禁用或 fallback 到慢得多的 Node.js 实现（scandal）。万级文件项目中，ripgrep 通常 1–2 秒出结果，scandal 可能卡顿 10 秒以上甚至假死。
- 进
Settings > Packages，搜find-and-replace，确认状态为Enabled - 点开该包设置页，检查
Use ripgrep（旧版叫Enable ripgrep support）是否勾选 - 终端执行
rg --version看系统是否装有ripgrep；Atom 会优先调用系统版，未安装时才 fallback 到内置二进制 - 临时禁用其他搜索类插件（如
advanced-open-file、project-find-plus），避免冲突
真正影响效率的，从来不是正则写得够不够炫，而是 File/directory pattern 漏填了一个星号、Only in open files 多勾了一次、Save All 忘按，或者以为 ripgrep 在跑结果它其实在用 scandal —— 这些地方一松懈，搜出来的就不是代码，是调试时间。
