VSCode中“隐藏文件”本质是通过files.exclude控制资源管理器显示,路径须为相对于工作区根的glob模式(如"/dist": true),应写入项目.vscode/settings.json;改search.exclude无效,宽泛模式如"/*"会导致文件树空白。

VSCode 里所谓“隐藏本地文件”,本质是控制资源管理器(左侧文件树)是否显示某些路径——它不删除、不移动、不修改文件,只改变视觉呈现。核心就一条:改 files.exclude。
files.exclude 怎么写才生效
所有路径都必须是相对于工作区根目录的 glob 模式,不是正则,也不是本地相对路径。写错就全白搭,甚至可能让整个文件树变空。
-
"**/dist"✅ 正确:递归匹配任意层级的dist目录 -
"dist"❌ 只匹配根目录下的dist,子目录里的照常显示 -
"dist/**"❌ VSCode 不认这种写法,直接忽略 -
"**/*"或"**"❌ 宽泛模式会过滤掉全部文件,资源管理器变空白 - 路径含空格(如
my folder)直接写"my folder": true,不用引号或反斜杠转义
该配在用户设置还是工作区设置
优先写进项目根目录下的 .vscode/settings.json。这是团队协作和项目隔离的唯一可靠方式。
- 用户级设置(全局)会影响你打开的所有项目,容易误伤其他项目
- 工作区设置(
.vscode/settings.json)自动覆盖用户设置,且只对当前项目生效 - 如果
.vscode文件夹不存在,手动创建;settings.json必须是完整 JSON 对象,不能只写一个字段 - 示例结构:
{ "files.exclude": { "**/node_modules": true, "**/*.exe": true } }
常见错误现象和对应解法
很多人配完没反应,不是 VSCode 坏了,而是踩了这几个典型坑:
- 改了
search.exclude却指望侧边栏消失 —— 它只管搜索框(Ctrl+Shift+F),和资源管理器无关 - 规则加了但没勾选 ✅ —— 在设置 UI 里添加模式后,务必确认复选框是激活状态
- 改完不刷新 —— 大多数情况下保存即生效,无需重启;若仍不生效,检查是否有插件(如 GitLens)主动读取并展示被隐藏路径
- 想保留部分子目录却写错顺序 —— 比如要隐藏
node_modules但留着@types,得这么写:"node_modules": true, "!node_modules/@types": true
,且!规则必须放在通用规则之后
真正麻烦的不是配置本身,而是路径语义的理解偏差:VSCode 的 files.exclude 是纯前端渲染过滤,它不参与构建、不干预 Git、也不影响终端命令。一旦你开始怀疑“为什么我删不掉这个文件夹”,大概率是把“隐藏”和“忽略”“删除”“Git 排除”混为一谈了。











