项目内查找特定字词必须用ctrl+shift+f（win/linux）或cmd+shift+f（macos），而非ctrl+f；后者仅搜索当前文件，因二者机制独立：ctrl+f为纯文本局部匹配，ctrl+shift+f基于ripgrep引擎全局扫描，且受file/directory pattern、only in open files及项目根目录三处隐性开关控制。
项目内查找特定字词，必须用 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS），不是 Ctrl+F。后者只搜当前文件，根本扫不到其他文件。
为什么按 Ctrl+F 找不到项目里的词？
这是最常踩的坑：Ctrl+F 永远只作用于当前打开的编辑器 tab，哪怕你开了 50 个文件，它也只在光标所在的那个文件里找。项目级搜索和局部搜索是两套完全独立的机制，快捷键、面板、底层引擎都不同。
-
Ctrl+F是纯文本匹配，不支持正则、不区分大小写（默认）、不跨行 -
Ctrl+Shift+F走的是ripgrep引擎，能扫整个项目目录、支持正则、可排除路径 - 如果快捷键没反应，先去
Settings > Packages搜find-and-replace，确认状态为 “Enabled”
Ctrl+Shift+F 面板里搜不到文件？检查三处隐性开关
搜不到 ≠ Atom 坏了，大概率是范围被悄悄收窄了：
-
File/directory pattern输入框非空（比如残留了src/**/*.js或!node_modules）→ 只搜匹配 glob 的路径，其余全跳过；清空它才全量扫描 -
Only in open files被勾选 → 即使项目有 1000 个文件，也只搜当前已打开的 tab；批量操作前务必取消勾选 - 项目根目录以首个
Add Project Folder为准；加了多个路径，Atom 不会自动合并，得手动在 pattern 框里写frontend/**这类子路径
想精准匹配函数名或带符号的词？正则必须开 .* 按钮
Atom 默认把搜索框内容当纯字符串处理，\binitRouter\b 或 function\s+\w+ 这类正则写了也白写——除非点开搜索框右侧的 .* 图标（或按 Alt+R）激活 PCRE2 引擎。
- 捕获组用
$1引用，写\1会被当字面量输出 - 点
Aa按钮开启大小写敏感，否则搜HTTP会漏掉http - 跨行匹配必须加
(?s)前缀，比如(?s)export\s+default\s+.*?;，原生不支持[\s\S]写法 - 替换时
Replace All是直写磁盘的，无预览、不可跨文件撤回；务必先点Find All看结果列表是否合理
中文路径或空格目录导致报错 error: unrecognized option 怎么办？
ripgrep 对 shell 解析敏感，遇到中文路径名、含空格的目录名（如 my project）容易崩。这不是 Atom 的 bug，而是底层工具限制。
- 首选方案：把项目移到纯英文、无空格路径下（如
/home/user/myproject） - 临时 workaround：在
File/directory pattern框里手动加引号，比如"my project"/src/**/*.js（部分版本有效） - 别在 pattern 框里输
./开头的相对路径——Atom 会把它解释为“仅本层”，不递归
真正容易被忽略的是：ripgrep 是否启用、core.excludeVcsIgnoredPaths 是否打开、ignoredNames 是否包含 node_modules ——这三者共同决定哪些文件进搜索范围，改完必须重启 Atom 才生效。
