VSCode 提供五种文件排除方式:一、工作区 settings.json 配置 files.exclude;二、用户 settings.json 全局排除;三、自动读取 .gitignore;四、用 files.watcherExclude 优化性能;五、右键临时排除文件夹。

如果您在使用 VSCode 编辑项目时发现搜索、文件树或 IntelliSense 被大量无关文件干扰,则可能是工作区中包含了本应忽略的临时文件、构建产物或依赖目录。VSCode 提供了“文件排除”机制,可通过配置精准控制哪些文件和文件夹不参与显示与索引。
本文运行环境:MacBook Air,macOS Sequoia。
一、通过 workspace 设置排除文件
该方法作用于当前工作区,配置保存在 .vscode/settings.json 中,对团队协作友好且不会影响其他项目。
1、在 VSCode 中打开您的项目根目录。
2、点击左下角齿轮图标,选择“设置”,或使用快捷键 Cmd + ,。
3、在右上角点击“打开设置(JSON)”图标(两个重叠的方块)。
4、在 settings.json 文件中添加 "files.exclude" 字段,例如:
"files.exclude": {"**/node_modules": true, "**/.git": true, "**/*.log": true}
二、通过用户设置全局排除
该方法适用于所有工作区,适合统一屏蔽操作系统或开发工具生成的通用冗余文件,但需谨慎避免误排除必要内容。
1、打开 VSCode 设置界面(Cmd + ,)。
2、点击左上角“用户”标签页(而非“工作区”)。
3、在搜索框中输入 files.exclude。
4、点击“在 settings.json 中编辑”,在右侧用户 settings.json 中添加规则:
"files.exclude": {"**/.DS_Store": true, "**/Thumbs.db": true, "**/dist": true}
三、利用 .gitignore 同步排除
VSCode 默认读取项目根目录下的 .gitignore 文件,并自动将其中的路径模式应用于文件资源管理器和搜索功能,无需额外配置即可实现一致性排除。
1、确保项目根目录存在 .gitignore 文件。
2、在该文件中添加需隐藏的条目,例如:
.idea/
__pycache__/
*.swp
3、保存文件后,VSCode 会立即刷新文件树,匹配行将不再显示。
四、使用 files.watcherExclude 提升性能
当项目包含大量动态生成文件(如监听日志、热重载输出)时,文件系统监视器可能持续触发,导致 CPU 占用升高;此设置可阻止 VSCode 监视指定路径,从而减轻负担。
1、打开当前工作区的 .vscode/settings.json。
2、添加 "files.watcherExclude" 字段,格式与 files.exclude 类似但语义不同:
"files.watcherExclude": {"**/logs/**": true, "**/output/**": true}
五、临时排除单个文件夹(不修改配置)
适用于快速验证某目录是否为干扰源,或在共享环境中无法修改配置时的即时操作。
1、在资源管理器中右键点击目标文件夹。
2、选择“在资源管理器中排除”选项。
3、该文件夹将立即从视图中消失,并在设置中自动生成一条临时 files.exclude 条目,形如:"folder-name/": true。










