ctrl+shift+f（windows/linux）或cmd+shift+f（macos）是atom唯一有效的项目级搜索入口，右键“search directory”仅限当前子目录；正则需手动启用.*按钮，捕获组用$1而非\1；搜索受.gitignore和file/directory pattern双重限制；replace all无预览、不跨文件撤销，操作前须确认路径、pattern及未勾选only in open files。

Ctrl+Shift+F 是唯一有效的项目级搜索入口

Atom 不支持右键点击项目根目录触发全局搜索，这是新手最常卡住的地方。快捷键 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）才是调起「Find in Project」面板的正确方式。右键菜单里的「Search Directory」仅对单个子目录生效，不会扫描 src/、lib/ 等平行路径。

常见错误现象包括：右键项目名无反应、点了「Search Directory」却只改了当前文件夹、改完发现 test/ 或 types/ 里漏掉了相同逻辑。

• 必须先通过 File > Add Project Folder 打开完整项目，而不是只打开几个零散文件
• 如果快捷键无效，优先检查是否被输入法、远程桌面或系统快捷键劫持
• 面板弹出后焦点默认落在 Find in project 输入框，直接输入即可，无需手动点击

正则替换必须点 .* 按钮，且捕获组用 $1 不是 \1

Atom 默认关闭正则模式，即使你写了 \d+ 或 foo.*bar，只要没点搜索框右下角的 .* 图标，就按纯文本匹配——这是 80% 的“正则不生效”问题根源。

替换时引用捕获组必须用 $1、$2……最多到 $9；写成 \1 会原样输出字符，不会还原内容。

• 查找：(console\.log)\(([^)]+)\) → 匹配 console.log(x) 中的 x
• 替换：debug('%s', $2) ✅；debug('%s', \2) ❌（结果是字面量 \2）
• macOS 用户可用 Cmd+Alt+F 快速切换正则开关，别误用 Cmd+Shift+F

搜索范围受 .gitignore 和 File/directory pattern 双重限制

你搜不到某个文件，大概率不是 Atom 没扫到，而是它被主动跳过了。Atom 默认尊重 .gitignore，同时还会读取 core.ignoredNames 配置（比如默认忽略 node_modules、dist、build）。

右上角的 File/directory pattern 输入框也参与过滤：留空才扫描所有类型；填了 *.ts 就只搜 TS 文件；填了 src/** 就只扫 src 下；误填会导致大面积漏搜。

• 想排除 node_modules？不用手动加 !node_modules，它本就在 .gitignore 里，默认已被跳过
• 想强制包含某类被忽略的文件？得临时注释掉 .gitignore 对应行，或改 Atom 设置里的 core.excludeVcsIgnoredPaths
• 路径含中文或空格时，ripgrep 容易报 error: unrecognized option，建议改用英文路径

Replace All 没预览、不跨文件撤销，操作前必须确认作用域

Atom 的 Replace All 是真·无缓冲修改：一次点击，所有匹配位置立即变更，且 Ctrl+Z 只能撤回当前文件的改动，其他文件已永久写入。

最容易被忽略的是右下角那个 Only in open files 勾选项——一旦勾选，哪怕你打开了整个项目，也只替换当前已打开的 tab 页，重构时极易酿成线上事故。

• 批量替换前务必核对左上角显示的搜索路径是否为你预期的根目录
• 确认 Only in open files 未勾选（默认是关闭的，但有人会误点）
• 大项目建议先试 Find All 查看命中数量和分布，再决定是否 Replace All

真正危险的不是功能不会用，而是你以为它会预览、会提示、会帮你兜底——它不会。每次 Replace All 前，多花三秒看一眼路径、pattern、open files 状态，比事后翻 Git log 强十倍。