让文件夹在资源管理器中彻底消失：files.exclude 的正确用法

files.exclude 控制资源管理器显示，不是 search.exclude

想让某个文件夹从左侧资源管理器里彻底“隐身”？关键一步是配置 files.exclude，而不是 search.exclude。这里有个常见的误区：很多人以为“排除”就是全局生效，结果配了 search.exclude 之后，发现文件夹在搜索框里不见了，但在侧边栏依然“坚挺”。其实，这两个配置项分工明确：search.exclude 只管 Ctrl+Shift+F 的搜索结果，对资源管理器视图毫无影响。

你是不是也遇到过类似情况？

• 在 settings.json 里信心满满地写下 "search.exclude": {"**/dist": true}，一回头，dist 文件夹还在资源管理器里原封不动。
• 在设置界面搜索“exclude”，看到选项就勾选，没留意点中的其实是 search.exclude 的开关。

正确的做法很直接：明确添加 files.exclude 配置项。路径的写法与 search.exclude 一样，都支持 glob 模式，比如：

• "**/node_modules": true —— 一劳永逸地隐藏所有层级的 node_modules 文件夹。
• "**/logs/**": true —— 隐藏所有 logs 目录及其内部的一切（注意末尾的 /** 表示递归匹配子内容）。
• ".DS_Store": true —— 清理 macOS 系统自动生成的隐藏文件，让视图更清爽。

工作区设置优先于用户设置，.vscode/settings.json 才管用

接下来是另一个关键点：配置写在哪里？如果你希望某个隐藏规则只对当前项目生效（例如，只想在后端服务项目里隐藏 dist，而前端项目则保留），就必须把配置写入项目根目录下的 .vscode/settings.json 文件中。VSCode 会优先读取这个工作区配置，并覆盖你的全局用户设置。

具体操作可以分几步走：

• 首先，确认你的项目根目录下有没有 .vscode 文件夹。如果没有，手动创建一个。
• 然后，在这个文件夹里新建或编辑 settings.json 文件。这里有个细节要注意：文件内容必须是一个完整的 JSON 对象，不能只写单个字段。
• 一个完整的配置结构示例如下：

  {
    "files.exclude": {
      "**/dist": true,
      "**/build": true,
      "**/coverage": true
    }
  }

• 保存文件后，效果立竿见影——资源管理器会立刻刷新，无需重启 VSCode。

路径匹配要注意相对性，别漏掉 **/ 前缀

配置写对了地方，但路径没写对，同样会功亏一篑。files.exclude 中的路径是相对于当前工作区根目录进行匹配的，并且必须使用 glob 模式。一个典型的错误是写成 "dist" 或 "dist/**"：前者只会匹配根目录下那个名叫 dist 的文件夹，对于嵌套在子目录里的就无能为力了；后者则因为缺少起始通配符，属于无效格式。正确的写法是 "**/dist" 或 "**/dist/**"。

下面这几个坑，你是不是也踩过？

• "dist/**" → 不生效，VSCode 不识别这种非标准的 glob 开头。
• "src/dist" → 只匹配 src 目录下的 dist，会漏掉像 packages/foo/dist 这样的深层目录。
• "**/dist/**" → 虽然能隐藏整个目录，但比 "**/dist" 多了一次路径遍历，对实际效果没有增益，反而可能略微拖慢资源管理器的渲染速度。

隐藏后文件仍可能被其他功能“暴露”

最后，必须明确一点：files.exclude 仅仅是在视觉上对资源管理器进行了一层过滤，它并不改变文件的真实存在，也不影响 VSCode 的其他底层功能。这意味着：

• 使用 Ctrl+P（快速打开文件）时，你仍然可以搜索并打开被隐藏的文件，除非你同时在 search.exclude 里也添加了相同的规则。
• 在集成终端里执行 ls 或 find 命令，结果完全不受该设置影响。
• 调试、Git 提交、任务运行等所有功能，都照常可以访问这些路径。

所以说，VSCode 里并不存在绝对的“彻底隐藏”。如果某个已经被你“排除”的文件夹，还是时不时在其他地方冒出来，那很可能是因为它被某个已安装的扩展（比如 GitLens、File Utils 等）单独列出了。这时候，你需要去对应扩展的设置里，找到相关的显示选项并将其关闭。