atom全局搜索需检查三处开关：file/directory pattern须留空、取消勾选only in open files、确保正确添加项目路径；正则替换用$1而非\1，需点亮右下角.*图标；启用ripgrep并验证系统安装；replace all无预览且不可跨文件撤回。

Atom 全局搜索不是“按了 Ctrl+Shift+F 就万事大吉”，它默认只扫你明确添加进项目的路径，且受三处隐性开关控制——漏掉任何一个，搜不到就是常态。

Ctrl+Shift+F 搜不到整个项目？先检查这三处开关

很多人输完关键词没结果，实际是搜索范围被悄悄收窄了：

• File/directory pattern 输入框非空（比如误填了 src/**/*.ts 或 !node_modules），就会跳过其他路径或后缀——留空才全扫
• Only in open files 若被勾选，哪怕项目里有 200 个文件，也只搜当前已打开的 tab 页——这是批量重构时最常误触的开关
• 你通过 Add Project Folder 加了多个路径，Atom 默认以第一个为基准；想限定到某子目录，得手动在 pattern 框里写 folder1/**，而不是指望它自动识别

正则替换写对了却没效果？大概率是引用语法或跨行问题

Atom 用的是 JavaScript 正则引擎，不是 sed 或 Python 风格：

ContentBot

一款面向内容营销的AI写作与自动化工具，可辅助生成博客、营销文案及其他网站内容，适合持续进行内容生产。

下载

• 捕获组必须用 $1、$2……最多到 $9；\1 在替换框里不会还原捕获内容，只会原样输出反斜杠加数字
• . 默认不匹配换行符，所以 start.*end 在多行文本里会失效；得显式写 start[\w\W]*?end（[\s\S] 在部分 Atom 版本中解析异常，不推荐）
• 右下角那个 .* 图标必须点亮——80% 的“正则不工作”问题卡在这一步；macOS 用户可用 Cmd+Alt+F 快速切换

搜索慢？别硬等，先确认 ripgrep 是否真在跑

Atom 自带的 find-and-replace 包底层已集成 ripgrep（rg），但这个加速开关不是全自动的：

• 进 Settings > Packages，搜 find-and-replace，确保状态为 “Enabled”
• 点开该包设置页，检查 Use ripgrep（旧版叫 Enable ripgrep support）是否勾选
• 终端执行 rg --version 看系统是否装有 ripgrep；Atom 会优先调用系统版，未安装时 fallback 到内置二进制
• 临时禁用其他搜索类插件（如 advanced-open-file、project-find-plus），避免冲突

Replace All 是真·无预览、无分步确认、无跨文件撤回

Atom 的 Replace All 是直写磁盘的，出错只能靠 Ctrl+Z 撤回——而且仅限当前文件，其他文件已永久修改：

• 先用 Find All 看右侧结果面板里列出的文件数和行数是否合理
• 若涉及重构（如重命名函数），建议先关掉 Only in open files，再清空 File/directory pattern，最后手动点开几处结果验证上下文
• 对大型项目，宁可分两次：第一次用 Find in project 定位所有候选位置，第二次打开关键文件用 Ctrl+F + Replace 逐个确认

最易忽略的一点：项目搜索不提供替换预览，Replace All 前不验证作用域，Ctrl+Z 也救不回来。