Visual Studio Code 怎么只搜索当前文件夹：工作区范围、排除项与结果核对

平时用 Visual Studio Code 梳理项目内容的时候，很多人遇到的问题根本不是不会搜索，而是搜索范围不知不觉就变大了：结果里混进了构建产物、依赖目录的内容，或是你明明只想查某个子目录的代码，却把整个工作区的匹配项全列了出来，翻半天都找不准要的内容。最稳妥的操作思路是先在资源管理器里选定目标文件夹缩小范围，再到搜索视图里核对包含规则、排除规则和忽略配置就行。

先确认 VS Code 当前打开的工作区

VS Code 语境里的“当前文件夹”，通常指你已经打开的项目根目录；如果当前窗口没有打开任何文件夹，跨文件搜索就没有稳定的项目边界。你可以先从顶部菜单选择 File > Open Folder，或是直接在欢迎页打开项目根目录，打开后资源管理器顶部显示的目录，就是后续所有路径匹配规则的参照点。

如果项目使用多根工作区，还要注意工作区可能包含多个根文件夹。此时搜索结果的来源目录会分别显示，不能把一个根目录下的 ./src 当成另一个根目录下的同名目录。

只查某个子目录：从资源管理器启动搜索

假设项目里有 src、tests 和 dist 三个目录，现在只想查 src 中的配置键。最省心的路径是：

1. 在 Explorer 面板中展开项目根目录。
2. 右键点击你要搜索的目标子目录，选择 Find in Folder。
3. 在自动弹出的搜索视图中输入你要查找的内容就可以了。

这个入口会直接把你选定的目录边界自动带入搜索条件，适合临时核对某个功能模块的内容，不需要提前去修改全局配置文件。官方示例里的跨文件搜索界面会按文件分组列出所有命中位置，展开对应文件就能直接看到前后代码上下文。

需要更精确时，填写包含和排除范围

按 Ctrl+Shift+F（macOS 系统下为 Shift+Command+F）打开 Search 视图，再点搜索框下方的展开按钮，就能看到 files to include 和 files to exclude 两个独立输入框。

包含范围适合表达“只看哪里”，例如输入 ./src 表示工作区根目录下的 src；输入 src/**/*.ts 则进一步限定文件类型。排除范围适合表达“这里不要看”，例如输入 dist 或 **/*.min.js。多个模式用逗号分隔，路径使用正斜杠。

要避免把搜索结果误判成“文件不存在”，可以先清空排除框做一次对照，再逐个恢复规则。搜索视图中的路径模式与设置文件里的 glob 规则并不完全相同：设置中的目录匹配通常要写成 **/example，而搜索视图会把 ** 前缀视为默认存在。

结果少了，检查忽略设置和大小写规则

VS Code 默认会减少某些目录带来的噪声。高级搜索区域里的 Use Exclude Settings and Ignore Files 开关，会影响是否应用 .gitignore、files.exclude 和 search.exclude。如果开关处于启用状态，目标文件可能不是没有内容，而是被规则排除了。

工作区设置可以写在项目根目录的 .vscode/settings.json 中，例如：

{
  "search.exclude": {
    "**/dist": true,
    "**/*.min.js": true
  }
}

还要留意平台差异：files.exclude 和 search.exclude 的 glob 大小写行为遵循操作系统的文件系统规则。Windows 和 macOS 通常不区分大小写，Linux 通常区分；搜索文字本身的 Match Case 开关又是另一层控制，不能混为一谈。

把搜索结果核对成一个可复现的结论

完成一次搜索后，你可以留三个方便后续复查的信息：搜索关键词、包含/排除匹配规则，还有是否开启了忽略设置。点击搜索结果里的文件名直接打开对应内容，再切回 Explorer 面板确认下文件确实处在你指定的目标目录下。要是搜出来的结果还是不符合预期，可以按「清空排除规则 → 关闭忽略设置 → 重新执行搜索」的顺序排查，很快就能定位到是哪条规则带来的偏差。

常见问题

为什么输入文件名却没有结果？

遇到搜不到内容的情况，先确认当前窗口打开的是正确的文件夹，再检查包含规则里的路径有没有写错；如果目标文件本身处在默认被忽略的目录里，可以暂时关掉 Use Exclude Settings and Ignore Files 选项做一次对照搜索。

Find in Folder 和全局搜索有什么区别？

Find in Folder 直接从资源管理器的目标目录启动，适合一次性的局部内容核对；全局搜索面向当前打开的文件夹或工作区生效，适合需要反复调整包含、排除和忽略规则的深度排查场景。

为什么 macOS 和 Linux 的结果数量不同？

除了项目文件本身可能不同，glob 的大小写匹配也可能不同。检查目录名和扩展名的大小写，再分别确认 .gitignore 与 search.exclude 的规则。

把目录入口、范围匹配模式和忽略设置的逻辑一起理清楚，之后再遇到「内容明明存在却搜不到」的情况，你就能快速判断到底是搜索词出了问题，还是目标文件根本没有被纳入本次的搜索范围。