Atom全局搜索搜不到文件是因为三处隐性开关控制范围：File/directory pattern非空时只搜匹配路径、勾选“Only in open files”时仅搜已打开文件、项目根目录以首个Add Project Folder为准；同时受.gitignore和core.ignoredNames双重过滤。
Atom 的批量替换不是“点一下就全改”，它默认不扫整个项目，也不自动跳过 .gitignore 里的路径，一不留神就会漏文件、改错地方，甚至直接破坏代码结构。
为什么 Find in project 搜不到目标文件？
根本原因不是 Atom 坏了，而是三处隐性开关同时在过滤搜索范围：
-
File/directory pattern输入框非空（比如残留了src/**/*.js或!dist），Atom 就只搜匹配该 pattern 的路径，其他一律跳过——必须清空才能全量扫描 - 勾选了
Only in open files，哪怕你项目里有 500 个文件，也只搜当前已打开的 tab —— 这是重构时最常误触的坑 - 项目根目录以第一个
Add Project Folder为准；加了多个路径，想限定到某个子目录，得手动写frontend/**，不能指望 Atom 自动识别
另外，node_modules、dist/ 这类路径既在 .gitignore 里，又受 Atom 的 core.ignoredNames 双重过滤，搜不到大概率是被主动跳过了，不是没扫到。
正则替换怎么写才真正生效？
Atom 默认把输入当纯文本处理，写 \d+ 或 function\s+(\w+) 不会触发正则——必须点亮右下角的 .* 图标（或按 Alt+R）：
- 捕获组引用必须用
$1、$2……最多到$9；写\1不报错，但会原样输出字面量\1 -
.默认不匹配换行符，所以start.*end在多行文本里必然失效；要跨行，得显式写start[\w\W]*?end（[\s\S]在部分版本中解析异常，不推荐） - 大小写敏感需手动点
Aa按钮开启，否则搜HTTP会漏掉http
Replace All 为什么容易出事？
Replace All 是直写磁盘的，没有预览、不分步、不可跨文件撤回：
- 点击后所有匹配位置立即变更，
Ctrl+Z只能撤回当前文件的改动，其他文件已永久修改 - 务必先点
Find All，看右侧结果面板列出的文件数和行数是否合理——如果只显示 2 个文件却要改 20 处，大概率 pattern 写错了或范围被收窄了 - 涉及函数重命名等重构操作，建议分两步：先用
Find in project定位全部候选位置，再手动打开几处关键文件，用Ctrl+F+Replace逐个确认上下文
真正麻烦的不是怎么点按钮，而是替换后是否破坏了语义依赖（比如 config 文件里 key 的顺序）、是否把注释里的相似字符串也改了、或者把路径里不该动的部分连带替换了——这些没法靠开关控制，只能靠人眼快速验证前几处结果。
