工作区设置必须写入项目根目录的.vscode/settings.json才能生效,它会覆盖用户配置且无需重启;files.exclude仅控制资源管理器显示,不影响GitLens或ESLint等扩展行为。

直接改 .vscode/settings.json 就行,不用重启 VS Code
工作区设置是局部隐藏的唯一可靠方式,它会覆盖用户级配置,且修改后资源管理器立刻刷新(2026 年起已无需重启)。关键不是“怎么配”,而是“配在哪”:必须写进项目根目录下的 .vscode/settings.json,而不是用户设置里。
常见错误是改了全局 settings.json 却没效果——因为当前文件夹下已有 .vscode/settings.json,它会完全屏蔽用户配置。验证方法:命令面板运行 Preferences: Open Workspace Settings (JSON),看是否已存在 files.exclude 字段。
- 如果不存在,手动创建
.vscode文件夹和settings.json,填入完整 JSON 对象(不能只写单个字段) - 如果已存在,直接在
"files.exclude"对象里增删规则,不要删掉整个对象再重写 - 路径必须用 glob 模式,且全部相对于工作区根目录;
"dist"无效,"**/dist"才对
files.exclude 的 glob 写法容易错在哪
VS Code 不认正则、不认绝对路径、也不接受本地相对路径写法。它只吃标准 glob,而且匹配逻辑很实在:"**/node_modules" 匹配子目录里的 node_modules,但不匹配根目录下的同名文件夹——后者得单独加 "node_modules": true。
-
"node_modules": true→ 只隐藏根目录下的node_modules -
"**/node_modules": true→ 隐藏所有子目录里的node_modules(如packages/foo/node_modules) -
"**/node_modules/**": true→ 和上一条效果几乎一样,但多一次遍历,无必要 -
"**/.*": true→ 默认就存在,会隐藏所有点文件(.env、.gitignore),删它才能让.env显出来 -
"**/*": true或"**": true→ 整个资源管理器变空,不是崩溃,是全被过滤了
为什么文件藏了,但 GitLens 或 ESLint 还能看见
files.exclude 只控制左侧资源管理器和 Ctrl+P 列表的显示,不干涉任何扩展或底层读取行为。GitLens 会主动扫描 .git 目录,ESLint 默认检查所有 JS 文件——它们压根不看 files.exclude。
- 想让 GitLens 不显示某些文件?得去它的专属设置里关,比如
gitlens.files.exclude - ESLint 要跳过
dist?靠.eslintignore,不是files.exclude - 临时验证是否真隐藏:先禁用所有扩展,再看资源管理器;如果这时文件也没了,说明配置生效了
别把 search.exclude 当成 files.exclude 的替身
很多人想“搜的时候别进 node_modules”,却去动 files.exclude,结果左侧文件树全没了,还纳闷为啥 Ctrl+Shift+F 还那么慢。这是两套独立系统:
-
files.exclude:管左侧文件树、Ctrl+P、新建/保存弹窗路径提示 -
search.exclude:只管Ctrl+Shift+F搜索范围,不影响任何显示 - 两者值格式一样,但互不同步;你删了
files.exclude里的"**/.*": true,search.exclude里可能还留着,导致.env能看见但搜不到 - 临时跳过搜索?用搜索框右上角的
files to exclude输入框填node_modules/**,比改配置更安全
真正难的不是写对一行 glob,而是搞清哪些功能受它影响、哪些完全不受——很多“不生效”其实是其他地方在悄悄抵消它。


















