VSCode 如何隐藏不需要的文件和文件夹 VSCode 隐藏文件和文件夹的设置方法_网络技术

VSCode 如何隐藏不需要的文件和文件夹 VSCode 隐藏文件和文件夹的设置方法

发布时间 - 2025-08-04 00:00:00 点击率：次

要在vscode中隐藏文件和文件夹，需修改settings.json中的files.exclude和search.exclude配置；2. files.exclude控制文件浏览器中不显示的文件，search.exclude控制全局搜索时排除的文件；3. 可通过用户设置（全局生效）或工作区设置（仅当前项目生效）进行配置，工作区设置优先级更高；4. 隐藏文件仅是界面显示和搜索过滤，不影响文件实际存在和项目运行；5. 应仅隐藏编译产物、依赖目录、系统文件等非核心开发文件，避免误藏关键配置文件；6. .gitignore用于版本控制忽略，与vscode隐藏功能无关，但常忽略相同目录。正确配置可提升开发效率和视觉清晰度，且不会影响项目功能。

在VSCode里要隐藏文件和文件夹，最直接的办法就是动一动它的设置，特别是

files.exclude

和

search.exclude

这两个地方。一个管着文件管理器里能看到啥，另一个则是在你搜索的时候，哪些文件会被跳过。这能让你的工作区看起来清爽很多，减少不必要的视觉干扰，也能提升一点点搜索效率。

解决方案

要隐藏VSCode中的文件和文件夹，核心操作就是修改其配置，通常是在

settings.json

文件中进行。你可以选择针对所有项目生效的用户设置，或是只针对当前项目生效的工作区设置。

打开设置：
- 通过菜单：
```
文件
```
  (File) ->
```
首选项
```
  (Preferences) ->
```
设置
```
  (Settings)。
- 通过快捷键：
```
Ctrl + ,
```
  (Windows/Linux) 或
```
Cmd + ,
```
  (macOS)。
搜索相关设置： 在设置搜索框中输入
```
exclude
```
。你会看到
```
Files: Exclude
```
和
```
Search: Exclude
```
两个选项。

编辑

settings.json

：点击这些选项旁边的“在 settings.json 中编辑”链接（或者直接点击右上角的

{}

图标）。

在打开的

settings.json

文件中，你可以添加或修改以下配置：

{
    // 控制文件浏览器中显示的文件和文件夹
    "files.exclude": {
        "**/.git": true,          // 隐藏 .git 文件夹
        "**/.svn": true,          // 隐藏 .svn 文件夹
        "**/.DS_Store": true,     // 隐藏 macOS 特有的 .DS_Store 文件
        "**/node_modules": true,  // 隐藏 node_modules 文件夹
        "**/dist": true,          // 隐藏编译输出的 dist 文件夹
        "**/build": true,         // 隐藏构建输出的 build 文件夹
        "**/*.log": true,         // 隐藏所有 .log 文件
        "*.bak": true             // 隐藏所有 .bak 备份文件
    },
    // 控制搜索时排除的文件和文件夹
    "search.exclude": {
        "**/node_modules": true,  // 搜索时排除 node_modules 文件夹
        "**/bower_components": true, // 搜索时排除 bower_components 文件夹
        "**/dist": true,
        "**/build": true,
        "**/*.log": true
    },
    // 如果你只希望在文件浏览器中隐藏，但不影响搜索，可以只设置 files.exclude
    // 如果你只希望在搜索中隐藏，但不影响文件浏览器，可以只设置 search.exclude
}

```
true
```
表示隐藏。
路径可以使用通配符：
- ```
*
```
  匹配路径段中的零个或多个字符（不包括路径分隔符）。
- ```
**
```
  匹配路径中的零个或多个路径段。
- ```
?
```
  匹配路径段中的一个字符。

保存

settings.json

文件后，VSCode 会立即应用这些更改。

为什么我们需要隐藏VSCode中的特定文件或文件夹？

说白了，这事儿主要是为了“眼不见为净”和提高效率。作为一个开发者，我桌面上乱七八糟的文件尚且要整理，更何况是代码项目里那些动辄几百上千个文件的依赖包或者编译产物。

首先，视觉上的简洁是第一位的。像

node_modules

这种文件夹，随便一个前端项目就有可能占据好几百MB甚至上GB，里面文件数量庞大，平时开发根本不需要去点开它。如果不隐藏，文件浏览器里一大片都是这些无关紧要的目录，找个自己写的业务代码文件简直是灾难。把它们藏起来，我能更专注于核心代码，减少那种“信息过载”的焦虑感。

其次，这还关乎到性能和体验。虽然现代电脑性能都不错，但VSCode在索引文件、进行全局搜索时，如果需要遍历所有文件，尤其是一些巨型目录，响应速度肯定会受影响。把

node_modules

、

dist

、

build

这种明确知道不需要搜索的目录排除掉，能显著加快全局搜索的速度。想象一下，你只想找一个函数定义，结果搜索结果里跳出来几百个来自

node_modules

里的同名文件，那简直是噩梦。

再者，这也是一种工作流的优化。不同的项目有不同的编译产物或者临时文件，比如Python的

__pycache__

、Java的

target

、C#的

bin

和

obj

。这些文件在开发过程中是自动生成的，不属于版本控制的一部分，也通常不需要手动编辑。将它们隐藏起来，可以避免误操作，也能让团队成员之间保持一致的开发环境视图。这不仅仅是个人的习惯，很多时候也是团队协作效率的一部分。

VSCode隐藏文件的方法有哪些？用户设置与工作区设置有何区别？

隐藏文件的方法，核心就是那两个设置项：

files.exclude

和

search.exclude

。它们各自管辖的范围和目的有所不同，但都是通过在

settings.json

里定义规则来实现的。

files.exclude

：这个设置项主要影响VSCode的文件浏览器（侧边栏的Explorer视图）。当你把某个文件或文件夹路径添加到

files.exclude

里并设置为

true

，那么它就不会在文件浏览器中显示出来。这对于减少视觉噪音，让你的项目结构看起来更清晰非常有帮助。比如，我通常会把

.git

、

.vscode

（有时候，看情况）、

node_modules

、

dist

、

build

这些目录加进去，它们虽然存在于硬盘上，但在我日常开发中，很少需要直接在文件浏览器里去操作它们。

search.exclude

：顾名思义，这个设置项影响的是VSCode的全局搜索功能（

Ctrl+Shift+F

或

Cmd+Shift+F

）。当你在搜索框里输入关键词时，VSCode会跳过所有在

search.exclude

中定义为

true

的文件和文件夹。这对于提升搜索效率至关重要，特别是那些包含大量第三方代码或编译产物的目录。我一般会把

node_modules

、

bower_components

、

dist

、

build

等目录添加到这里，因为我几乎不会在这些地方搜索我的业务代码。

至于用户设置与工作区设置的区别，这其实是VSCode配置体系的一个核心概念，理解它非常重要：

用户设置 (User Settings)：这是全局性的设置，保存在你的用户目录下（例如Windows上的
```
%APPDATA%\Code\User\settings.json
```
，macOS上的
```
~/Library/Application Support/Code/User/settings.json
```
）。一旦你在这里配置了
```
files.exclude
```
或
```
search.exclude
```
，它就会对你用这个VSCode实例打开的所有项目都生效。这非常适合那些你希望在任何项目中都隐藏的文件，比如
```
.DS_Store
```
、
```
Thumbs.db
```
这种操作系统生成的文件，或者你个人习惯性不看的
```
.log
```
文件。
工作区设置 (Workspace Settings)：这是项目特有的设置，保存在你项目根目录下的
```
.vscode/settings.json
```
文件中。它只对当前这个项目生效。这种设置的优先级高于用户设置。这意味着，如果你在用户设置里隐藏了
```
foo
```
文件夹，但在某个项目的工作区设置里明确说
```
foo
```
不隐藏（或者没有设置），那么在这个特定项目里
```
foo
```
就会显示。工作区设置非常适合团队协作，因为它能确保所有开发者在打开同一个项目时，都能看到一致的文件视图和搜索行为。比如，某个项目的编译产物目录叫
```
output
```
，你就可以在工作区设置里隐藏它，而不会影响到其他项目。

在我看来，最佳实践是：把那些你个人觉得在任何项目中都碍眼的文件（比如操作系统文件）放在用户设置里；而把那些与具体项目构建、依赖相关的、需要团队成员共同遵守的隐藏规则放在工作区设置里。这样既能保证个人使用的便利性，也能兼顾团队协作的规范性。

隐藏文件后，如何确保项目功能不受影响？

隐藏文件，本质上只是VSCode在界面上的一种“障眼法”，或者说是它在搜索时的一种“过滤策略”。这些文件本身并没有被删除，也没有从文件系统中消失，更不会影响到你的项目实际的运行、编译或部署。所以，从这个角度看，隐藏文件本身并不会直接导致项目功能受损。

然而，真正需要注意的，是你隐藏了什么。

一个常见的误区是，有人可能会把项目运行或构建过程中需要被引用或读取的文件也隐藏了。例如，如果你的项目需要一个

config.json

文件来读取配置，而你又把它加到了

files.exclude

里，那么你在VSCode里就看不见它了。虽然这不影响程序运行时去读取它，但如果未来你需要手动编辑这个配置文件，或者排查相关问题，你会发现找不到它，这就会带来不便和困惑。

所以，关键在于：只隐藏那些你确定在日常开发中不需要直接查看或操作的文件和文件夹。

编译产物：比如
```
dist/
```
、
```
build/
```
、
```
target/
```
、
```
bin/
```
、
```
obj/
```
。这些是代码编译或打包后生成的，通常不需要手动修改。
依赖管理目录：
```
node_modules/
```
、
```
bower_components/
```
、
```
vendor/
```
（PHP Composer）。这些是第三方库的安装位置，你通常只会通过包管理器（npm, yarn, composer等）来管理它们，而不是直接去改里面的文件。
版本控制系统文件：
```
.git/
```
、
```
.svn/
```
。这些是版本控制系统用来管理代码历史的，普通开发者不会直接操作它们。
操作系统或IDE生成的文件：
```
.DS_Store
```
(macOS),
```
Thumbs.db
```
(Windows),
```
*.log
```
(日志文件),
```
*.bak
```
(备份文件)。这些文件通常是系统或工具自动生成的，对项目功能无影响。
临时文件或缓存：某些框架或工具生成的临时缓存目录。