files.exclude 配合 / 前缀才能递归隐藏子目录;仅 "dist": true 仅隐藏根目录下 dist,需 "/dist/**": true 才彻底隐藏所有层级 dist 及其内容。

用 files.exclude 配合 **/ 前缀才能递归隐藏子目录
直接写 "dist": true 只会隐藏项目根目录下的 dist,它的子目录(比如 dist/assets、dist/js/main.js)依然显示。真正要“隐藏指定目录下的所有子文件”,必须用 glob 的递归通配符 **/ 开头。
-
"**/dist": true—— 隐藏所有层级中名为dist的目录(包括根目录和任意子路径下的),但不会隐藏该目录内部的文件名匹配规则(比如不单独影响dist/*.log) -
"**/dist/**": true—— 才是完整递归:它先匹配到dist目录,再匹配其下所有内容(文件 + 子目录),资源管理器里整个节点彻底消失 - 别写
"dist/**":缺少**/前缀,VS Code 不识别,整条规则无效 - 也别写
"**/dist/*":这只会隐藏dist下的直接子项,漏掉dist/a/b/c.js这类嵌套路径
files.exclude 和 search.exclude 是两套独立配置
很多人试了 search.exclude 发现左侧文件树没变化,是因为它只管 Ctrl+Shift+F 搜索结果,完全不影响资源管理器显示。要让目录从侧边栏消失,唯一有效的就是 files.exclude。
- 想同时屏蔽“显示”和“搜索”,两个字段都得手动加一遍,没有自动同步
- 工作区设置(即
.vscode/settings.json)优先级高于用户设置,推荐项目内配,避免污染其他项目 - 改完保存后立即生效,不用重启 VS Code(旧版本需重启,当前 2026 年已取消该限制)
含空格、点号或特殊字符的目录名怎么写
VS Code 的 glob 解析器对键名做了宽松处理,不需要转义,也不需要额外引号包裹整个键名。
- 写
"my folder": true,不是"\"my folder\"": true,也不是"my\ folder": true -
".vscode": true有效,可隐藏项目自动生成的配置目录 -
".git": true有效,但注意它只影响资源管理器——Git 功能本身(如源代码管理面板)不受影响 - 错误写法:
"**/.*"会误杀所有隐藏文件(包括你可能想保留的.editorconfig),慎用宽泛模式
负向排除(!)必须放在通用规则之后
如果你要隐藏 node_modules,但想保留 node_modules/@types 用于类型提示,就得用负向排除。但顺序错了就完全失效。
- 正确顺序:
"node_modules": true在前,"!node_modules/@types": true在后 - 错误写法:
"!node_modules/@types": true放在第一行 → 它被后续的"node_modules": true覆盖,@types 仍不可见 -
!只对它声明的那层路径生效:!node_modules/@types不会自动放行@types/react,后者仍被node_modules规则吃掉 - 要放行深层子目录,得补全路径,例如:
"!node_modules/@types/react": true
实际生效依赖路径是否严格相对于工作区根,且 glob 表达式不能有语法错误;一旦写成 "**/*" 或 "**" 这类无约束模式,整个资源管理器会变空——不是崩溃,是过滤过头了。











