VS Code Search Editor 怎样保存可复用的跨文件搜索条件

可以把 VS Code 的跨文件搜索条件保存下来，关键不是只保留 Search 侧栏里的历史词，而是把结果打开成 Search Editor 后再保存。这样查询词、正则开关、文件包含与排除范围会跟着搜索编辑器一起管理；以后重新打开时，再运行一次搜索即可得到当前工作区的新结果。

官方地址：https://code.visualstudio.com/docs/editing/codebasics

本文以反复查找“deprecated API”为例，说明入口、保存和复查边界。配图均为原创界面说明图，不是 VS Code 实际截图。

先分清搜索历史和 Search Editor 文件

因此，想让“同一套跨文件搜索条件”可复用，应保存 Search Editor；不要把希望寄托在查询历史上。历史可能只帮你找回关键词，却不会替代一次完整的范围配置。

第一步：从 Search 视图建立跨文件查询

1. 打开 VS Code 工作区，点击左侧活动栏的 Search，或使用默认快捷键 Ctrl+Shift+F（macOS 为 Command+Shift+F）。
2. 在查询框输入任务关键词，例如 deprecated API。需要区分大小写、整词或正则时，打开搜索框旁对应的匹配选项。
3. 展开搜索详情，填写 files to include 和 files to exclude。例如只查 src/**，并排除 **/node_modules/**。先确认结果树已经反映出预期范围。
4. 在结果树顶部点击 Open in editor；也可以打开命令面板，运行 Search Editor: Open Results in Editor。

如果看不到 Open in editor，先确认结果树已经产生搜索结果；也可以直接使用 Search Editor: Open New Search Editor 创建新的搜索编辑器，再填写条件。

第二步：保存 Search Editor 以便下次复用

1. 检查新打开的 Search Editor 顶部查询词、正则状态和文件范围。这里展示的是一次完整搜索配置，不是普通文本编辑器中的一段复制结果。
2. 使用菜单 File → Save As...，或按 Ctrl+Shift+S（macOS 为 Command+Shift+S），选择工作区中的文档目录并保存。文件名可使用能表达任务的名称，例如 api-search.code-search；重点是把它放到团队能理解和管理的位置。
3. 保存后观察编辑器标签页的未保存标记是否消失。若仍显示未保存状态，说明当前 Search Editor 仍有改动，先完成保存再关闭标签页。

保存的是搜索编辑器的配置与结果快照。源文件后来发生变化时，已保存文件不会自动代表最新结果；下次打开后应主动重新运行搜索。

第三步：重新打开并复查配置

1. 在资源管理器中打开保存的 Search Editor 文件，确认查询字段仍为 deprecated API，正则、大小写和整词选项没有被误改。
2. 核对 files to include 与 files to exclude。如果工作区切换了分支、目录或多根工作区，结果范围可能自然变化。
3. 点击 Search Again，或使用命令 Search Editor: Rerun Search，让结果反映当前文件内容。需要更多上下文时，检查 search.searchEditor.defaultNumberOfContextLines；它控制结果前后显示的上下文行数。

查询没有生效时按这张清单排查

还可以设置 search.searchEditor.reusePriorSearchConfiguration，让新建 Search Editor 时复用上一个搜索编辑器的配置。它适合连续处理同类任务，但不等于已经把某个 Search Editor 文件保存下来；两者应分别确认。

常见问题

只按过搜索框的向下箭头，算保存了搜索条件吗？

不算。那只是调用查询历史。要保留正则、文件范围和上下文等完整条件，应打开 Search Editor 并保存文件。

重新打开后结果数量变了，是保存失败吗？

通常不是。Search Editor 保存的是查询配置和当时的结果快照，源文件、分支或排除规则变化后，重新运行自然可能得到不同数量。

Search Editor 能不能当成源代码文件编辑？

它主要用于查看和复用搜索结果。不要把结果区域的文字修改误认为会直接改写源文件；需要修改源文件时，应跳转到对应结果位置再编辑。

最后确认

可复用的路径是：Search → 设置查询与范围 → Open in editor → File → Save As... → 重新打开 → Search Again。保存后先看查询配置是否完整，再判断结果是否符合当前工作区；把“配置没了”和“文件内容变了”分开处理，排错会快很多。