项目搜索必须用Ctrl+Shift+F（Win/Linux）或Cmd+Shift+F（macOS），调起“Find in Project”面板，底层为ripgrep引擎；需启用find-and-replace包，正则需点.*按钮激活，路径避免中文/空格，跨行匹配用(?s)，配置仅限Settings中相关选项。
用 Ctrl+Shift+F 打开项目搜索，不是文件内搜索
很多人按 Ctrl+F 后发现只在当前文件里找，根本没扫整个项目——这是最常踩的坑。项目级搜索必须用独立快捷键：Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS），它会直接调起「Find in Project」面板，底层走的是 ripgrep 引擎，不是简单字符串遍历。
- 如果快捷键没反应，先检查
find-and-replace包是否启用（Settings > Packages > find-and-replace） - 面板底部的
File/Directory pattern框能限制范围，比如填src/**/*.js就只搜 JS 文件，填!node_modules可手动排除（虽然.gitignore里的目录默认已被ripgrep自动跳过） - 别在搜索框里输中文路径名或带空格的目录名——
ripgrep对 shell 解析敏感，容易报错error: unrecognized option，换成英文路径或加引号更稳
正则搜索要开 .* 按钮，否则当普通文本处理
Atom 默认把输入当字面量匹配，哪怕你写了 \d+ 也不会识别为“数字”。必须点搜索框右侧的 .* 图标（或按 Alt+R）才能激活 PCRE2 正则引擎——这步漏掉，所有高级模式都失效。
- 函数定义常用模式：
function\s+(\w+)\s*\(\)或const\s+(\w+)\s*=\s*\(.*?\)\s*=>，捕获组命名不支持，但可用$1在替换中引用 - 想跨行匹配？
ripgrep默认不支持，得加-U参数——但 Atom UI 不暴露这个开关，只能改配置：在Settings > Packages > find-and-replace > Settings里勾选Use Regex并确保ripgrep已启用，然后手动在搜索框里写(?s)start.*?end（(?s)开启单行模式） - 大小写敏感默认关闭，搜
HTTP可能漏掉http，需要点旁边Aa按钮开启
atom.workspace.scan 是插件开发用的，别在配置里硬改
网上有些教程让你去改 src/ripgrep-directory-searcher.js 或直接调 atom.workspace.scan API，这其实是给 Atom 插件作者看的内部接口。普通用户改了不仅无效，还可能被下次更新覆盖。
-
atom.workspace.scan(/pattern/, {ripgrep: true}, cb)只能在插件的.coffee或.js文件里运行，编辑器配置页（config.cson）里写这行会直接报语法错误 - 真正影响全局搜索行为的配置项只有几个：
core.excludeVcsIgnoredPaths（是否遵循 .gitignore）、find-and-replace.useRegex、find-and-replace.preserveCase，全在 Settings 里可点选 - 如果发现搜索变慢，先关掉
find-and-replace.showResultsAsSymbols（这个选项会让 Atom 尝试解析符号结构，对纯文本项目纯属拖累）
搜索结果点不跳转？检查文件是否被 tree-view 隐藏了
明明搜到了 utils.js 里的某行，点击结果却没打开文件——大概率是 tree-view 包把该文件标记为“忽略项”了，导致 Atom 认为它不属于当前项目上下文。
- 进
Settings > Packages > tree-view > Settings，取消勾选Hide VCS Ignored Names（即使你没动过这选项，某些 Git 初始化异常也会让它误判） - 或者临时在搜索面板的
File/Directory pattern里填完整路径，比如/full/path/to/project/src/utils.js，绕过路径解析逻辑 - 极少数情况是文件编码问题：Atom 对
UTF-16或带 BOM 的文件搜索支持弱，搜不到就试试用 VS Code 确认是否存在，再考虑转码
dist/ 或 build/，它照样会扫进去拖慢响应——别只信“自动忽略”，关键目录还得人工核对一遍。 
