Fuzzy Finder 默认内置但需启用且项目路径正确才能使用；常见无响应原因是插件禁用或快捷键冲突，需检查启用状态、禁用干扰插件，并通过命令面板验证；搜索范围限于已添加的项目根目录，新建文件需等待索引或手动重建；可配置忽略列表和文件权重提升精度；行号跳转格式为“文件:行号”，跨项目搜索需勾选对应选项。
Fuzzy Finder 不需要手动安装，Atom 1.0+ 版本已默认内置，但必须启用且项目路径正确才能用。
为什么按 Ctrl+T（Windows/Linux）或 Cmd+T（macOS）没反应
最常见原因是插件被禁用，或快捷键被其他插件覆盖。不是 Atom 坏了，是状态不对。
- 进
Settings → Packages → fuzzy-finder，确认状态是Enabled，不是Disabled - 如果启用了多个快捷键插件（比如
vim-mode-plus或atom-keyboard-macros），它们可能劫持了Cmd+T；可临时禁用它们测试 - 快捷键冲突时，用
Cmd+Shift+P（命令面板）搜Fuzzy Finder: Toggle手动触发，验证是否真失效
搜不到新文件或目标文件？检查项目根目录和索引状态
Fuzzy Finder 只搜 Atom “知道”的路径，不是全盘扫描——它依赖你主动添加的项目文件夹，且索引有延迟。
- 必须通过
File → Add Project Folder添加完整项目根目录（比如/Users/me/my-app），只打开单个文件或桌面文件不会被纳入搜索范围 - 新建文件后不会立刻出现在结果里，等 2–3 秒；若仍不出现，执行
Cmd+Shift+P → Fuzzy Finder: Rebuild Index - 文件若在
node_modules、dist/、.git等默认忽略路径下，也不会被索引——这不是 bug，是设计行为
怎么让搜索更准、更快、少噪音
默认行为偏宽松，但干扰项（如日志、构建产物）会拉低效率，需针对性配置。
- 进
Settings → Packages → fuzzy-finder → ignoredNames，填入："node_modules", "*.log", ".DS_Store", "dist/"—— 注意末尾斜杠表示整个目录 - 改完必须重启 Atom，热重载不生效
- 想提升某类文件权重（比如优先匹配
.ts而非.js），在config.cson中加：fuzzyFinder: { inclusionPriority: [".ts$", ".jsx$"] } - 输
apih能命中api-handler.ts，但输api-handler反而可能因过长、含连字符导致匹配弱；建议用驼峰或简写片段
行号跳转和跨项目搜索的关键细节
这两个功能看似简单，但参数格式和作用域限制极易踩坑。
- 跳转到具体行：搜
router.js:150，中间不能有空格；仅对已索引文件有效，未保存的临时文件不支持 - 行号超出实际长度时，它静默跳到最后一行，不提示、不报错
- 跨多个项目搜索（如同时开了
frontend和backend）：默认只搜第一个项目；必须点开Ctrl+Shift+F搜索面板右上角齿轮 → 勾选Search in all project folders -
Ctrl+Shift+F不支持(?i)这类内联正则标志，忽略大小写请直接关掉Match Case开关
真正卡住的往往不是算法或快捷键，而是 Atom 根本没“看见”你要找的路径——花 30 秒确认 Add Project Folder 是否点对了，比调半天配置有用得多。
