VSCode 项目配置管理：5种常见文件过滤模式与 glob 语法详解

weixin_30425949

374人浏览 · 2026-07-10 14:47:24

weixin_30425949 · 2026-07-10 14:47:24 发布

VSCode 项目配置管理：5种常见文件过滤模式与 glob 语法详解

在软件开发过程中，项目目录往往会随着时间推移积累大量非核心文件——构建产物、依赖目录、版本控制文件、临时文件等。这些文件虽然对项目运行是必要的，但在日常编码时却会成为视觉干扰和搜索负担。VSCode 作为现代开发者的主力编辑器，提供了精细化的文件过滤机制，让开发者能够专注于真正需要编辑的代码文件。

1. 理解 VSCode 的排除机制

VSCode 通过两个核心设置实现文件过滤：

files.exclude ：控制资源管理器中的文件显示
search.exclude ：控制全局搜索的文件范围

这两个设置都使用 glob 模式匹配语法，但作用域不同。一个常见的误区是认为只需配置其中一项就能完全隐藏文件，实际上：

{
  "files.exclude": {
    "**/node_modules": true
  },
  "search.exclude": {
    "**/node_modules": true
  }
}

提示：即使配置了 files.exclude ，未排除的文件仍可能出现在搜索结果中。最佳实践是同时配置这两项，除非你确实需要在隐藏文件中搜索内容。

排除设置支持三级作用域：

作用域	配置文件位置	优先级
用户级	`~/.config/Code/User/settings.json`	最低
工作区	`.vscode/settings.json`	中等
文件夹	多根工作区中的文件夹配置	最高

当不同作用域的配置冲突时，VSCode 会采用"就近原则"——更接近项目文件的配置具有更高优先级。

2. 5 种核心 glob 模式详解

glob 是一种简化版的正则表达式，专为文件路径匹配设计。以下是五种最实用的模式：

2.1 递归匹配 ( `**/*` )

这是最常用的模式，表示"任意层级的任意文件"：

{
  "files.exclude": {
    "**/.git": true,
    "**/*.log": true
  }
}

**/.git ：隐藏所有 .git 目录
**/*.log ：隐藏所有后缀为 .log 的文件

2.2 单级目录匹配 ( `*/` )

只匹配当前层级的目录：

{
  "files.exclude": {
    "temp/": true,
    "build/": true
  }
}

这不会隐藏子目录中的同名文件夹。例如配置 build/ 会隐藏项目根目录的 build 文件夹，但不会隐藏 src/build/ 。

2.3 字符集匹配 ( `[abc]` )

匹配方括号内的任意单个字符：

{
  "files.exclude": {
    "test/[abc]*.js": true
  }
}

会匹配 test/a1.js 、 test/b.config.js
不会匹配 test/d.js 或 test/ab.js

2.4 反向字符集 ( `[!abc]` )

匹配不在方括号内的任意单个字符：

{
  "search.exclude": {
    "src/[!aeiou]*.ts": true
  }
}

会排除 src/basic.ts 、 src/config.ts
不会排除 src/app.ts 、 src/entity.ts

2.5 范围匹配 ( `{a,b,c}` )

匹配花括号内任意一个模式：

{
  "files.exclude": {
    "**/*.{map,log,tmp}": true
  }
}

这相当于同时配置了三种文件类型，是一种简洁的写法。

3. 项目类型特化配置模板

不同技术栈的项目需要排除的文件类型差异很大。以下是针对常见项目的推荐配置：

3.1 Node.js 项目

{
  "files.exclude": {
    "**/node_modules": true,
    "**/.npm": true,
    "**/coverage": true,
    "**/dist": true,
    "**/*.min.js": true,
    "**/package-lock.json": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/coverage": true,
    "**/dist": true
  }
}

3.2 Python 项目

{
  "files.exclude": {
    "**/__pycache__": true,
    "**/.mypy_cache": true,
    "**/.pytest_cache": true,
    "**/*.pyc": true,
    "**/*.pyo": true,
    "**/venv": true
  }
}

3.3 嵌入式 C/C++ 项目

{
  "files.exclude": {
    "**/Debug": true,
    "**/Release": true,
    "**/build": true,
    "**/*.hex": true,
    "**/*.bin": true,
    "**/*.map": true
  }
}

4. 高级配置技巧

4.1 条件式排除

通过组合 glob 模式实现更精细的控制：

{
  "files.exclude": {
    "src/**/*.{spec,test}.js": true,
    "!src/core/**/*.test.js": true
  }
}

这个配置会：

隐藏所有测试文件（*.spec.js 或 *.test.js）
但保留 core 目录下的 *.test.js 文件

4.2 与 Git 忽略规则同步

VSCode 可以自动应用 .gitignore 中的规则：

{
  "files.exclude": {
    "**/.git": true,
    "**/.gitignore": true
  },
  "search.exclude": {
    "**/.git": true
  },
  "explorer.excludeGitIgnore": true
}

设置 explorer.excludeGitIgnore 为 true 后，VSCode 会自动隐藏被 .gitignore 忽略的文件。

4.3 多工作区配置

对于包含多个子项目的复杂工作区，可以在每个子项目的 .vscode 目录中单独配置：

workspace/
├── frontend/
│   ├── .vscode/
│   │   └── settings.json
│   └── src/
├── backend/
│   ├── .vscode/
│   │   └── settings.json
│   └── src/
└── .code-workspace

每个 settings.json 只需包含该子项目特有的排除规则。