Sublime Text全局搜索范围由Where输入框唯一控制:填.搜整个项目,src/搜src下所有文件(含子目录),., -node_modules/, -dist/排除指定目录,留空仅搜已打开文件。

Where 输入框填什么才真正切换搜索范围
Sublime Text 的全局搜索(Ctrl+Shift+F)不靠“当前打开的文件”或“侧边栏选中项”来限定范围,唯一生效的控制点是 Where 输入框——它不是辅助选项,而是硬性路径过滤器。
常见错误是留空或填错格式:留空 ≠ 搜整个项目,它实际等价于只搜已打开的标签页;填 ./src 或 src\ 会因路径解析失败导致零结果。
-
.(单个英文点):表示项目根目录,递归搜索全部子目录和文件 -
src/:只搜src/下所有文件(含子目录),斜杠必须在末尾,不加**也默认递归 -
src/**/*.py:只搜src/及其任意深层子目录下的 Python 文件 -
., -node_modules/, -dist/:逗号分隔,排除指定目录,斜杠统一用正斜杠 -
open_files:唯一合法值,表示只搜当前已打开但未保存的标签页(其他写法如*.js在此无效)
为什么刚加了新文件夹却搜不到
执行 File → Add Folder to Project 后,Sublime Text 会触发后台索引,右下角显示 Indexing…。在此期间,新增文件不会被 Ctrl+Shift+F 扫描到——不是功能失效,是索引未完成。
Mac 用户还需注意:Cmd+Shift+F 常被系统 Spotlight 占用,需去「系统设置 → 键盘 → 快捷键 → Spotlight」关闭 Cmd+Shift+F 的全局绑定。
- 等待右下角
Indexing…消失后再执行搜索 - 若添加的是符号链接目录,确保 Sublime 已启用
follow_symlinks: true(在用户设置中) - 检查项目根目录是否包含非法字符或过长路径(尤其 Windows 下的 260 字符限制)
多项目共存时如何避免范围串扰
Sublime Text 的项目上下文完全由左下角状态栏显示的路径决定,例如 ~/my-app/。如果状态栏没显示路径,说明当前处于“单文件模式”,Ctrl+Shift+F 面板会灰显或仅作用于已打开文件。
切换项目不是靠“关掉再开”,而是通过 Project → Open Project 或 ProjectManager 插件加载 .sublime-project 文件——该文件定义了 folders 数组,才是 Sublime 认可的“项目边界”。
- 不要用
File → Open Folder直接打开子目录,这会覆盖当前项目上下文 - 多个项目共存时,每个项目的
.sublime-project应明确设置folder_exclude_patterns,避免跨项目误搜node_modules等共享目录 - 使用
ProjectManager插件时,快捷键Ctrl+Alt+P呼出的列表只显示已保存的项目,不会混入临时打开的文件夹
替换后内容没保存?这是设计,不是 bug
点击 Replace All in Files 后,所有变更都暂存在内存中,不会自动写入磁盘。这是 Sublime Text 明确的设计选择,目的是防止误操作污染文件系统。
必须手动触发保存:Windows/Linux 按 Ctrl+K 松开 → 再按 Ctrl+B;macOS 是 Cmd+K → Cmd+B。这个组合键执行的是 Save All,而非单个文件保存。
- 没有弹窗提示、没有自动保存、也没有“是否保存更改”二次确认
- 如果中途关闭窗口或崩溃,未执行
Save All的替换将彻底丢失 - 建议搭配 Git 使用:替换前先
git status确认工作区干净,替换后立刻git diff核对变更范围











