files.exclude只控制资源管理器显示,不生效主因是配置位置错、glob路径误写或布尔值非true;必须写入.vscode/settings.json,用"**/xxx": true等正确glob语法,且files.exclude与search.exclude完全独立。

files.exclude 为什么只隐藏部分文件,不生效?
根本原因是 files.exclude 只控制资源管理器(左侧文件树)的显示,不干预搜索、代码分析或 Git 行为。如果改了没反应,大概率是:配置位置错了、通配符写法不对、或路径匹配逻辑被忽略。
-
files.exclude必须写在.vscode/settings.json(工作区)或用户设置中,全局用户设置影响所有项目,但会被工作区同名配置覆盖 - 模式用的是 glob 语法:
**/表示任意层级子目录,/开头表示项目根级,比如/venv/≠**/venv/ - 值必须是
true,不能写"true"字符串或1 - 修改后无需重启 VSCode,但需确保没被其他扩展或设置覆盖(比如某些 Python 扩展会强制显示
__pycache__)
常见文件/文件夹怎么写排除规则
写错路径是最常踩的坑。下面这些是经过验证的典型写法,直接复制粘贴即可用:
- 隐藏所有
__pycache__目录:"**/__pycache__/": true(注意结尾斜杠,避免误匹配同名文件) - 隐藏所有
.pyc文件:"**/*.pyc": true - 隐藏项目根下的
dist和build目录:"dist/": true、"build/": true - 隐藏 macOS 的隐藏文件:
"**/.DS_Store": true、"**/._*": true - 隐藏 Windows 编译产物:
"**/*.exe": true、"**/*.dll": true
files.exclude 和 search.exclude 有什么区别?
这是最容易混淆的一点:files.exclude 管左侧文件树是否显示;search.exclude 管 Ctrl+Shift+F 搜索时是否扫描该路径。两者规则写法一致,但作用完全独立。
- 如果只想让文件“看不见”,但搜索还能搜到,只配
files.exclude - 如果想彻底屏蔽干扰(比如日志、构建产物),两个都得配,例如:
"**/logs": true同时出现在files.exclude和search.exclude中 - 某些目录如
node_modules建议两个都排除,否则搜索结果里全是第三方库的匹配项
为什么 .gitignore 里的内容没自动隐藏?
VSCode 不会自动把 .gitignore 转成 files.exclude 规则。它最多在资源管理器里“折叠”已忽略的目录(需开启 files.associations 或相关实验性设置),但这不是真正隐藏,且行为不稳定。
- 要确保左侧看不到,必须显式写进
files.exclude - 已有提交过的文件(比如历史遗留的
.vscode/)即使加了files.exclude,也可能因 Git 缓存残留而继续显示 —— 需运行git rm -r --cached .vscode清理 - 团队协作时,务必把
files.exclude放进工作区.vscode/settings.json,而不是用户设置,否则别人看不到效果
实际生效的关键就一句话:路径模式对、布尔值对、位置对。其他所有“不生效”的情况,基本都能回溯到这三点。











