要让文件夹在资源管理器中完全不显示，必须配置 files.exclude，而非 search.exclude；后者仅影响搜索结果。路径需用 glob 模式如 "**/dist"，且应写入工作区 .vscode/settings.json 中。

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

想让某个文件夹在左侧资源管理器里完全不出现，必须用 files.exclude，而不是 search.exclude。后者只影响 Ctrl+Shift+F 搜索结果，对侧边栏毫无作用。很多用户配了 search.exclude 后发现文件夹还在资源管理器里，就是混淆了这两个配置项。

常见错误现象：

• 在 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

避免常见的 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 只控制资源管理器的视觉呈现，不影响任何底层行为。这意味着：

• Ctrl+P（快速打开文件）仍能搜到被隐藏的文件，除非你额外配了 files.exclude 同时也配了 search.exclude
• 终端里执行 ls 或 find 不受该设置影响
• 调试、Git 提交、任务运行等一切功能照常访问这些路径

真正“彻底隐藏”的并不存在——VSCode 的 files.exclude 本质只是 UI 层过滤。如果某个文件夹频繁意外出现在你眼前，大概率是因为它被其他扩展（比如 GitLens、File Utils）单独列出了，这时得去对应扩展的设置里关掉相关选项。