Sublime全局搜索搜不到内容，主因是未通过File→Open Folder加载项目目录，导致Ctrl+Shift+F灰显或仅搜当前文件；Where需填“.”搜整个项目，填错路径或留空将导致范围错误。
全局搜索报错行号或关键字时，为什么搜不到？
Sublime 的 Ctrl+Shift+F（Windows/Linux）或 Cmd+Shift+F（macOS）默认只搜当前项目已打开的文件夹，如果错误日志里提示的是 app/utils.py:42，但 utils.py 所在目录没被添加进侧边栏，那它根本不会被纳入搜索范围。
常见错误现象：终端报了 KeyError: 'user_id'，你在整个工程里搜 'user_id'，结果返回零结果——大概率是搜索范围漏掉了某个子模块目录。
- 确认左侧边栏显示的根路径是否覆盖全部源码目录；没显示的要右键 →
Add Folder to Project - 检查底部状态栏是否显示
0 files或1/1 files—— 后者说明只搜了当前文件，不是全局 - 避免误点
Find in Files对话框右上角的...按钮，它会把搜索范围缩成单个文件，而不是展开目录树
正则模式下匹配 traceback 行和变量名要注意什么？
Python 报错栈里常出现类似 File "/path/to/handler.py", line 87, in post 这样的行，想快速定位到出问题的函数，得用正则精准抓取，而不是盲目搜 line 87（可能多处出现）。
实操建议：
- 打开
Find in Files面板，勾选Regular Expression（.*图标） - 搜
File.*handler\.py.*line 87——\.转义点号，.*容忍路径分隔符差异 - 搜变量名如
user_id时，加单词边界：\buser_id\b，避免匹配到user_id_map或super_user_id - 注意大小写：默认区分，若不确定，勾选
Match Case取消
搜索结果太多怎么快速筛选有效上下文？
搜一个通用字段（比如 status）可能返回几百行，真正相关的往往只有几处。靠人工翻效率极低，得利用 Sublime 自带的上下文折叠和跳转能力。
关键操作：
- 搜索后按
Ctrl+P（或Cmd+P），输入@可跳转到当前文件的 symbol（函数/类名），快速确认是不是目标上下文 - 在搜索结果面板中，双击某条结果，Sublime 会自动打开对应文件并高亮该行；再按
Ctrl+Shift+Up/Down可在本次搜索结果间跳转 - 右侧预览窗默认不显示，可在
Preferences → Settings中添加"preview_on_click": true，点结果直接预览，不打断当前编辑 - 临时排除某些目录：在
Where输入框加-folder_name，例如src -tests -migrations
为什么改了代码，搜索结果却不更新？
Sublime 不会自动监听文件系统变化刷新搜索缓存，尤其在你用脚本批量生成文件、或 Git 切换分支后，旧的搜索结果仍停留在内存里，导致“明明改了却搜不到新内容”。
这不是 Bug，是设计如此。解决方法很简单：
- 每次怀疑结果过期，手动按
Enter重执行一次搜索（不用清空输入框） - 如果用了
Where指定了路径，确保路径没因 Git checkout 变成软链接失效或权限变更 - 极少数情况（如 WSL 下挂载 Windows 目录），Sublime 可能无法读取新增文件，可尝试把项目根目录换成 WSL 原生路径（如
/home/user/project）
最易被忽略的一点：搜索面板里的 Replace 功能一旦激活，后续所有 Find in Files 都会默认带上替换逻辑，哪怕你没填替换内容——这会导致结果过滤异常。遇到诡异行为，先关掉替换栏再试。
