Ctrl+Shift+F打开的是项目查找而非当前文件查找，需先通过File > Add Project Folder加载项目根目录，否则搜索范围为空；面板左上角显示路径即确认成功，右上角File/directory pattern留空才全量扫描，ignoredNames和excludeVcsIgnoredPaths配置须正确设置并重启生效。
Ctrl+Shift+F 打开的是项目查找，不是当前文件查找
很多人按 Ctrl+Shift+F 后搜不到结果，第一反应是正则写错了，其实根本没进对入口——这个快捷键启动的是 Find in Project，作用域是“当前打开的整个文件夹”，不是单个文件。如果你只打开了一个 index.html，但没用 File > Add Project Folder 加载根目录，那搜索范围就是空的。
确认方式：面板左上角会显示类似 /path/to/your/project 的路径；如果只显示 index.html 或空白，说明没加载项目。
- 必须通过
File > Add Project Folder添加根目录，不能只靠打开单个文件 - 若同时打开多个文件夹，Atom 默认只以第一个为根，其余忽略
- 右上角
File/directory pattern输入框留空才扫描全部文件类型；填了*.js就只扫 JS 文件
ignoredNames 和 excludeVcsIgnoredPaths 决定哪些文件被跳过
搜索结果里混进 node_modules、dist、.log 文件？不是 Atom 慢，是它根本没过滤——默认不自动排除任何目录。两个配置项必须都设对：
-
Settings > Core > Ignored Names：手动加node_modules、dist、*.log（注意目录名后不加斜杠，文件模式加*） -
Settings > Core > Exclude VCS Ignored Paths：必须勾选，否则.gitignore规则不生效 - 改完必须重启 Atom，热重载不生效
特别注意：.gitignore 只在项目根目录存在 .git 且 excludeVcsIgnoredPaths 开启时才起作用；纯文件夹项目只能靠 ignoredNames。
正则跨行匹配必须用 [\w\W]，别信 .
想匹配从 <script> 到 </script> 的整块内容，包括换行？写 <script>[\s\S]*?</script> 在 Atom 里大概率失败——它不支持 [\s\S]，也不认 /s 标志。
- 实测有效写法：
<script>[\w\W]*?</script> -
[^]理论上等价，但某些 Atom 版本解析异常，不推荐 - 右下角
.*图标必须点亮，否则所有正则当纯文本处理 - 贪婪匹配如
.*跨多行极易回溯爆炸，优先用非贪婪.*?
批量替换前务必关掉 “Only in open files”
面板右下角那个小开关一旦勾上，Replace All 只会动当前已打开的 tab，其他匹配文件完全不动——这是批量替换漏改的头号原因。
- 执行前肉眼确认该选项未勾选（图标为灰色）
- 如果只想改部分文件，先用
File/directory pattern锁定路径，比如填src/**/*.ts - 替换预览列表里显示的文件数 ≠ 实际被改的文件数，最终以“已替换 X 处”为准
最可靠的过滤方式其实是项目根目录下建 .atomignore 文件，一行一个路径，改完立即生效，不用重启，也绕过 .gitignore 依赖。
