Vscode如何设置文件排除？Vscode搜索过滤规则添加指南-VSCode-PHP中文网

Vscode如何设置文件排除？Vscode搜索过滤规则添加指南

冰火之心

发布： 2025-07-02 19:11:01

原创

844人浏览过

在vscode中设置文件排除的方法有两种：通过settings.json文件和通过.gitignore文件。通过settings.json文件可全局或项目级设置，使用files.exclude控制资源管理器显示的文件，search.exclude控制搜索范围，并可通过!符号实现例外规则；通过.gitignore文件设置的排除规则优先级更高，适用于git项目中的构建产物等文件排除。若规则未生效，应检查语法、优先级或尝试重启vscode及清除缓存。

Vscode如何设置文件排除？Vscode搜索过滤规则添加指南

在Vscode中设置文件排除，主要是为了提高搜索效率，避免在不必要的文件中浪费时间。简单来说，就是告诉Vscode，在搜索或者某些操作的时候，忽略某些特定的文件或者文件夹。

解决方案

Vscode提供了两种主要的方式来设置文件排除：通过settings.json文件和通过.gitignore文件。

通过settings.json文件：

这是最常用的方法，你可以全局设置，也可以针对特定项目设置。
- 全局设置： 打开Vscode，点击文件 -> 首选项 -> 设置 (或者直接按 Ctrl + ,)，搜索files.exclude。你会看到一个JSON对象，在这里你可以添加需要排除的文件或文件夹的规则。
  
  例如，要排除所有的.pyc文件和__pycache__文件夹，可以这样设置：
```
{
    "files.exclude": {
        "**/.pyc": true,
        "**/__pycache__": true
    }
}
```
  登录后复制
  这里的**表示递归匹配，所以可以排除所有子文件夹中的.pyc文件和__pycache__文件夹。
- 项目设置： 在你的项目根目录下创建一个.vscode文件夹（如果还没有），然后在该文件夹下创建一个settings.json文件。在这个文件中添加相同的files.exclude配置，这样设置只会影响当前项目。项目设置会覆盖全局设置。
通过.gitignore文件：

如果你使用Git进行版本控制，那么.gitignore文件中的规则也会被Vscode的文件排除功能识别。这意味着你在.gitignore文件中排除的文件，在Vscode中也不会被搜索到。这对于排除一些构建产物、日志文件等非常有用。

例如，你的.gitignore文件中有以下内容：

纳米搜索
纳米搜索：360推出的新一代AI搜索引擎

30

查看详情
```
*.log
node_modules/
```
登录后复制
那么Vscode会自动排除所有的.log文件和node_modules文件夹。

注意：.gitignore的优先级高于settings.json，也就是说，如果一个文件同时被.gitignore和settings.json排除，那么以.gitignore为准。

Vscode的search.exclude和files.exclude有什么区别？

files.exclude主要影响文件在资源管理器中的显示，以及一些文件操作（例如，在“打开文件”对话框中）。search.exclude则专门用于控制搜索功能，决定哪些文件或文件夹不应该被搜索。简单来说，files.exclude影响的是文件浏览，search.exclude影响的是文件搜索。

在settings.json中，你可以同时配置files.exclude和search.exclude，例如：

{
    "files.exclude": {
        "**/.git": true,
        "**/.svn": true,
        "**/.hg": true,
        "**/CVS": true,
        "**/.DS_Store": true
    },
    "search.exclude": {
        "**/node_modules": true,
        "**/bower_components": true,
        "**/.vscode": true
    }
}

登录后复制

如何排除特定类型的文件，但保留特定文件？

这涉及到更复杂的规则设置。你可以使用!符号来表示“不排除”的意思。例如，你想排除所有的.js文件，但是保留main.js文件，可以这样设置：

{
    "files.exclude": {
        "**/*.js": true,
        "**/main.js": false
    }
}

登录后复制

注意，规则的顺序很重要。Vscode会按照规则的顺序进行匹配，后面的规则会覆盖前面的规则。所以，**/main.js": false必须放在**/*.js": true后面。

排除规则不起作用怎么办？

如果你的排除规则不起作用，可以尝试以下方法：

检查规则的语法是否正确。 JSON格式要求严格，确保你的规则符合JSON语法。
检查规则的优先级。 .gitignore的优先级高于settings.json，项目设置高于全局设置。
重启Vscode。 有时候Vscode可能没有正确加载配置文件，重启可以解决问题。
清除Vscode的缓存。 Vscode会缓存一些文件信息，有时候需要手动清除缓存才能使规则生效。你可以尝试删除.vscode文件夹下的extensions文件夹，然后重启Vscode。