VScode全局搜索屏蔽/显示屏蔽指定文件类型及文件夹的方法

VScode全局搜索屏蔽/显示屏蔽指定文件类型及文件夹的方法

在处理大型项目时，尤其是代码移植或重构阶段，我们常常会遇到一个情况：工程里混杂着一些当前并不需要的文件。直接删除？风险太大，毕竟它们可能在其他地方还有用。那么，有没有一种方法，既能保持工作区的清爽，减轻代码阅读和分析时的视觉负担，又不会动到源文件分毫呢？

答案是肯定的。Visual Studio Code 提供了非常灵活的文件与搜索排除功能，让你可以“眼不见为净”，同时保证文件安然无恙。

示例一：在文件资源管理器中屏蔽指定目录

最直接的方法，就是让某些文件夹从侧边栏的文件资源管理器里消失。这需要通过修改用户或工作区设置来实现。

具体来说，在 settings.json 配置文件中，添加 files.exclude 字段。它的键值对格式很简单："目录路径模式": true/false。设置为 true 意味着屏蔽，false 则意味着显示。

来看一个典型的配置：

"files.exclude": {
    "**/BUILD": true
}

这行配置的作用是，在所有子目录下名为“BUILD”的文件夹，都不会出现在文件树中。

示例二：通过设置界面快速配置

如果你不习惯直接编辑JSON文件，VScode的图形化设置界面同样强大且直观。

1. 打开设置

首先，使用快捷键 Ctrl + ,（在Mac上是 Cmd + ,）快速打开设置界面。

2. 配置搜索屏蔽 (search.exclude)

在设置顶部的搜索框中，输入 search.exclude。

这个设置项控制的是全局搜索结果中要排除的内容。点击下方“Add Pattern”按钮（图中红色箭头所指），就可以添加你想要屏蔽的文件或文件夹模式了。

例如，你可以添加：

**/*.git
**/PROJ
**/PROJ/OBJ

添加后的效果如下图所示，这些模式下的文件将不会出现在任何全局搜索的结果里：

3. 配置显示屏蔽 (files.exclude)

接下来，在搜索框中输入 files.exclude。

这个设置项专门控制文件资源管理器侧边栏的显示。同样点击“Add Pattern”来添加模式。一个关键点是：这里配置的排除项，默认也会从搜索中被排除。

例如，添加 **/PROJ：

配置完成后，相应的文件夹将从侧边栏隐藏，如下图所示：

示例三：项目级专属配置

上面的修改大多作用于全局用户设置。如果你想为某个特定项目定制排除规则，更优雅的做法是使用工作区设置。

操作步骤如下：在你的项目根目录下，新建一个名为 .vscode 的文件夹，然后在该文件夹内创建一个 settings.json 文件。将你的排除配置写在这个文件里，它只会影响当前这个项目。

这里有一个更完整的配置示例，结合了搜索屏蔽和显示屏蔽：

{
    "search.exclude": {
        "**/node_modules": true,
        "**/bower_components": true, // 这是VScode的默认配置之一
        "/arch/a vr32": true          // 这是自定义的、需要被禁止搜寻的文件夹
    },
    "files.exclude": {
        "**/.git": true,
        "**/.svn": true,
        "**/.hg": true,
        "**/CVS": true,
        "**/.DS_Store": true, // 这也是默认配置
        "arch/a vr32": true   // 这是自定义的、需要从文件资源管理器隐藏的文件夹
    }
}

实际的文件结构贴图如下，清晰展示了配置文件的存放位置：

相关说明与高级技巧

当需要排除的文件或文件夹数量众多，且命名有规律时，逐条添加会非常繁琐。这时，通配符 *（星号）就成了你的得力助手。

例如，如果你想屏蔽 board/ 目录下所有以数字开头的子文件夹，可以这样写：

"board/[0-9]*": true

同理，如果想屏蔽以字母a到e开头的子文件夹，配置则是：

"board/[a-e]*": true

掌握这些模式匹配的技巧，就能用极简的配置，管理极其复杂的项目结构，让开发环境真正为你所用，聚焦在核心代码上。