Atom全局搜索搜不到文件是因为搜索范围受三处隐性开关控制：File/directory pattern非空时只搜匹配路径、勾选“Only in open files”时仅搜已打开文件、项目根目录以首个Add Project Folder为准。
Ctrl+Shift+F 打开的 Find in project 面板根本没扫全项目？
默认只搜你用 Add Project Folder 添加的第一个路径，且受三处隐性开关控制：一旦 File/directory pattern 框里有内容（比如残留的 src/**/*.js 或 !node_modules），就会跳过其他路径；勾选了 Only in open files 就只搜当前 tab；项目根目录不是你当前打开的文件夹，而是首个添加的路径。
检查步骤：
- 确保
File/directory pattern输入框为空（删掉所有字符） - 取消勾选
Only in open files - 确认项目是通过
Add Project Folder添加的，而不是仅靠打开单个文件启动 Atom - 注意：
.gitignore和 Atom 的core.ignoredNames会联合过滤文件，node_modules、dist、.DS_Store默认被跳过，搜不到不等于没扫描
想用正则替换但 \d+ 或 function\s+(\w+) 没反应？
Atom 默认把输入当纯文本，写正则也不会生效——必须手动点右下角的 .* 图标（或按 Alt+R）开启正则模式。
几个关键细节：
- 捕获组引用写
$1、$2，写\1不报错但原样输出字面量 -
.默认不匹配换行符，跨行需显式写start[\w\W]*?end（[\s\S]在部分版本解析异常，别用） - 大小写敏感要手动点
Aa按钮，否则搜HTTP会漏掉http - 中文正则建议加
u标志（如/\p{Han}+/u），但 Atom 的正则引擎对 Unicode 属性支持有限，稳妥起见用[\u4e00-\u9fa5]+
点 Replace All 后代码全崩了怎么办？
Replace All 是直写磁盘、无预览、不可跨文件撤回的操作。Ctrl+Z 只能撤回当前文件，其他文件已永久修改。
安全操作流程：
- 先点
Find All，看右侧结果面板列出的文件数和行数是否合理（比如搜user却只列了 3 行，大概率范围没设对） - 涉及函数名/变量名重命名，务必分两步：先
Find in project定位全部候选位置，再手动打开几处关键文件，用Cmd+F+Replace逐个确认上下文 - 若替换后发现误改，立即关闭未保存的文件，避免 Ctrl+Z 覆盖已有改动
- 编辑器底层用的是
ripgrep（rg），确保find-and-replace包已启用，且设置页中Use ripgrep已勾选；终端运行rg --version确认系统装了ripgrep
为什么搜不到某个文件，但明明它就在项目里？
最常被忽略的是双重过滤机制：.gitignore 和 Atom 的 core.ignoredNames 共同决定哪些路径被跳过。比如 node_modules、dist、build、.log 文件，即使你手动添加了项目路径，它们也会被静默排除。
验证方法：
- 在终端进入项目根目录，执行
rg -g '!**/node_modules/**' --files | head -n 5，看ripgrep是否也跳过该文件 - 临时注释掉
.gitignore中相关行，再试一次搜索 - 在 Atom 设置中搜索
ignoredNames，检查core.ignoredNames是否包含你想搜的扩展名（如.tmp、.swp）
真正影响全局替换成败的，从来不是正则写得多漂亮，而是那三个小开关有没有关对、过滤规则有没有绕开、以及 Replace All 前有没有亲眼数过结果行数。
