<p>Sublime Text 全项目搜索核心为 Find in Files，通过 Ctrl+Shift+F（macOS 为 Cmd+Shift+F）调出面板，在 Find 框输入内容，Where 框设为 <project> 或指定路径，并支持用 – 排除目录如 -node_modules/，结合 *.js 等过滤文件类型；搜索结果在面板中双击跳转，可用 F4 导航，Replace 支持正则捕获组批量替换，建议先预览并确保版本控制；还可通过 .sublime-project 文件配置 file_exclude_patterns、folder_exclude_patterns 等实现排除规则持久化，提升团队协作效率。</p>
Sublime Text 进行全项目搜索，核心功能就是
Find in Files
。它不是简单地在当前打开的文件里找，而是能深入你整个项目目录，甚至可以精确到排除某些文件类型或文件夹。说实话，这功能在我日常开发里使用频率极高，特别是需要重构代码或者定位某个变量、函数在整个项目里的引用时，简直是神器。它比一般的全局搜索强大得多，因为它提供了非常灵活的过滤机制和正则匹配能力。
解决方案
在 Sublime Text 中进行全项目搜索，最直接的方式就是按下
Ctrl+Shift+F
（macOS 上是
Cmd+Shift+F
）。这会弹出一个搜索面板，里面有几个关键的输入框：
- Find: 你要搜索的文本或正则表达式。
- Where: 这是关键。默认情况下，它可能会显示
<current file>
或
<open files>
。要进行全项目搜索，你需要输入
<project>
。如果你想搜索特定的文件夹，可以直接拖拽文件夹到这个输入框，或者手动输入文件夹路径，多个路径用逗号分隔。
- Replace: 如果你想进行批量替换，就在这里输入替换内容。
具体操作步骤：
- 打开你的 Sublime Text 项目。
- 按下
Ctrl+Shift+F
(Windows/Linux) 或
Cmd+Shift+F
(macOS)。
- 在
Find
框中输入你想要查找的内容。
- 在
Where
框中，确保它显示为
<project>
。如果不是，手动输入
<project>
。你也可以输入一个或多个具体的目录路径，比如
src/, tests/
。
- 点击
Find
按钮，或者直接按
Enter
键，Sublime Text 就会在整个项目里搜索并显示结果。
搜索结果会显示在一个新的面板中，每一行都列出了匹配的文件名、行号以及匹配到的文本片段。双击任意一行，就可以直接跳转到那个文件和对应的位置。
Sublime Text 全项目搜索如何精确控制搜索范围，排除不必要的文件或目录？
在我看来，
Find in Files
的真正强大之处，就在于它对搜索范围的精细控制。很多时候，我们并不希望在
node_modules
、
.git
这种目录里搜索，或者只想搜索
.js
文件，而忽略
.map
文件。这里，
Where
框的语法就显得尤为重要。
你可以通过在
Where
框中添加前缀来指定包含或排除规则：
- 包含特定目录或文件类型：
-
src/, tests/
：只在
src
和
tests
目录下搜索。
-
*.js, *.jsx
：只搜索
.js
和
.jsx
文件。
-
src/*.js
：只搜索
src
目录下的
.js
文件。
-
- 排除特定目录或文件类型：
-
-node_modules/, -.git/
：排除
node_modules
和
.git
目录。这个
-
前缀是关键。
-
*.js, -*.min.js
：搜索所有
.js
文件，但排除掉
.min.js
文件。
-
-*.log
：排除所有
.log
文件。
-
你可以将这些规则组合起来使用。例如，
<project>, -node_modules/, -build/, *.ts, -*.d.ts
这条规则的意思是：在整个项目里搜索，但排除
node_modules
和
build
目录，并且只搜索
.ts
文件，同时排除
.d.ts
文件。这种组合方式非常灵活，可以根据你的项目结构和需求来定制。这块儿我个人踩过不少坑，一开始不知道怎么精确排除，结果每次搜索都一大堆无关结果，效率很低。
在 Sublime Text 中，如何高效地查看和管理 Find in Files 的搜索结果，并安全地进行批量替换？
搜索结果出来后，如何高效地处理它们也是一门学问。Sublime Text 会在一个新的“Find Results”面板中展示所有匹配项。
- 快速跳转： 最直接的方式就是双击结果列表中的任何一行，Sublime Text 会立即打开对应文件并定位到匹配的行。
- 导航结果： 你可以使用
F4
键跳转到下一个匹配项，
Shift+F4
键跳转到上一个匹配项。这在需要逐个检查匹配项时非常方便，特别是当你有很多结果时。
- 批量替换（Replace in Files）： 当你确定要进行批量替换时，可以在
Replace
框中输入替换内容。然后，点击
Replace
按钮（它会变成
Replace All
）。
关于批量替换，我必须强调一点： 务必谨慎！ 在点击
Replace All
之前，最好先进行一次纯粹的
Find
操作，仔细检查搜索结果是否符合预期。我见过不少同事因为粗心大意，一次性替换了错误的内容，导致项目出现问题。
我的建议是：
- 先预览： 总是先用
Find
确认搜索范围和匹配内容无误。
- 小范围测试： 如果是比较复杂的替换，可以先在一个小范围的文件或目录里测试替换效果。
- 版本控制： 确保你的代码已经提交到版本控制系统，这样万一替换出错了，也能迅速回滚。
- 正则替换的组捕获： 如果你使用正则表达式进行搜索，
Replace
框中可以使用
$1
,
$2
等来引用
Find
表达式中的捕获组，这在进行结构化替换时非常有用。比如，查找
(old_prefix)_(variable)
，替换成
new_prefix_$1
。
如何通过 Sublime Text 项目文件（.sublime-project）定制 Find in Files 的默认搜索路径和排除规则？
对于一个经常处理的、有特定结构的项目，每次手动输入排除规则会很麻烦。Sublime Text 提供了项目文件（
.sublime-project
）来持久化这些配置，这大大提升了效率。
一个
.sublime-project
文件本质上是一个 JSON 文件，你可以通过
Project > Save Project As...
来创建它。在这个文件里，你可以定义项目的文件夹、设置以及各种排除规则。
关键配置项：
在
settings
块中，你可以添加以下配置：
-
file_exclude_patterns
: 一个字符串数组，定义要从搜索和侧边栏中排除的文件名模式。
-
folder_exclude_patterns
: 一个字符串数组，定义要从搜索和侧边栏中排除的文件夹名模式。
-
binary_file_patterns
: 一个字符串数组，定义被视为二进制文件的模式，这些文件通常不会被搜索。
示例
.sublime-project
配置：
{ "folders": [ { "path": "." } ], "settings": { "tab_size": 4, "translate_tabs_to_spaces": true, "file_exclude_patterns": [ "*.log", "*.bak", "*.sublime-workspace" ], "folder_exclude_patterns": [ "node_modules", ".git", "dist", "build" ], "binary_file_patterns": [ "*.jpg", "*.png", "*.gif", "*.zip", "*.pdf" ] } }
当你打开这个项目文件后，
Find in Files
的默认行为就会遵循这里定义的排除规则。这意味着你不需要每次都在
Where
框中手动输入
-node_modules/
这样的排除项了，它会自动生效。这对于团队协作也很有帮助，可以确保所有开发者在同一个项目下有统一的搜索和文件显示行为。我个人习惯每个项目都配一个
.sublime-project
文件，这样能让工作环境更一致，也省去了很多重复配置的功夫。
sublime linux js git json node 正则表达式 windows mac pdf macos json 正则表达式 字符串 堆 map JS git windows macos sublime text linux 重构