files.exclude 中 "node_modules": true 仅匹配根目录下字面路径,无法递归匹配子目录(如 packages/foo/node_modules);必须用 "**/node_modules": true 才能生效。

files.exclude 为什么不能直接写 node_modules 就生效?
因为 files.exclude 的 glob 匹配是前缀匹配,不是模糊匹配。只写 "node_modules": true 只能隐藏工作区根目录下的 node_modules 文件夹;而子项目里(如 packages/foo/node_modules)完全不受影响。
真正要递归隐藏所有层级的同名文件夹,得用 "**/node_modules": true —— 注意开头的 **/ 表示“任意深度的子路径”。但也要小心:这个模式会匹配到 src/node_modules 这类非标准位置,如果项目结构特殊,可能误杀。
-
"node_modules": true→ 仅根目录 -
"**/node_modules": true→ 所有子目录,含嵌套 -
"**/node_modules/**": true→ 更严格,排除其内部所有内容(效果基本等同上一条) - 别写
"**/node_modules/*",末尾的/*会导致匹配失败
如何安全隐藏 __pycache__、.DS_Store、*.log 等临时文件?
这些文件散落在各层目录,必须用通配符递归匹配,且注意点文件(. 开头)默认已被 VSCode 内置规则 "**/.*": true 屏蔽——这意味着你很可能根本看不到 .env 或 .gitignore,除非你主动删掉这条规则。
推荐做法是显式列出高频干扰项,避免依赖默认行为:
-
"**/__pycache__": true→ Python 缓存目录 -
"**/.DS_Store": true→ macOS 系统元数据 -
"**/*.log": true→ 所有日志文件(注意不是*.log,缺**/只匹配根目录) -
"**/temp": true、"**/cache": true→ 常见临时目录名 - 想保留某个点文件(比如
.env)?删掉"**/.*": true,再单独加"**/.DS_Store": true和"**/.git/**": true
为什么改了 files.exclude,Ctrl+Shift+F 搜索还是扫到了 node_modules?
因为 files.exclude 只管左侧资源管理器和 Ctrl+P 文件跳转,它对全局搜索(Ctrl+Shift+F)完全无效。搜索走的是另一套配置:search.exclude。
这两个字段独立存在、互不继承。常见错误就是只配了前者,结果搜索卡顿依旧,还以为配置没生效。
- 要让搜索也跳过
node_modules,必须额外加:"search.exclude": { "**/node_modules": true } - 工作区级设置(
.vscode/settings.json)中可同时写两个字段,保持行为一致 - 临时测试?搜索框右上角有个“files to exclude”输入框,填
node_modules/**更快,不改配置 - 插件(如 GitLens)可能绕过
files.exclude主动读取被隐藏文件,验证时先禁用扩展
工作区设置 vs 用户设置:该写在哪?
优先写进项目根目录的 .vscode/settings.json。用户级设置(全局 settings.json)会影响所有项目,容易污染协作环境;而工作区设置只对当前文件夹生效,还能提交到 Git,让团队成员开箱即用。
但要注意覆盖逻辑:只要工作区里定义了 "files.exclude",整个对象就会完全替代用户级的同名配置——不是合并,是替换。所以别在用户设置里写一堆通用规则,又在工作区里只写一两条,结果其他规则全失效。
- 团队项目:统一放
.vscode/settings.json,加进.gitignore的除外(如密钥相关) - 个人脚手架项目:可预置常用排除,比如
"**/dist": true、"**/out": true - 语言专属排除?支持写成
"[javascript]": { "files.exclude": { "lib/**": true } },注意语言 ID 全小写 - 改完保存后,不用重启 VS Code,但需关闭再重新打开文件夹才能刷新资源管理器缓存
改错一个 glob 模式,比如 "**/*",整个资源管理器就空了——这不是崩溃,是真被过滤干净了。最稳妥的方式,永远是从小范围开始试:先隐藏单个文件夹,确认生效后再加其他项。











