VSCode侧边栏是否显示文件仅由files.exclude控制,而非.gitignore或系统隐藏属性;默认规则"*/.": true会隐藏所有点文件,需修改该配置来放行特定文件。

直接改 files.exclude 就行,不是靠 .gitignore,也不是靠系统隐藏属性——VSCode 的侧边栏是否显示某个文件,只认这个配置项。
为什么 .env、.secrets 等文件在资源管理器里看不到?
VSCode 默认启用 "**/.*": true 规则,它会匹配所有以点开头的文件(如 .env、.secrets、.gitconfig),并从侧边栏彻底过滤掉。这不是“系统级隐藏”,而是 VSCode 主动不渲染。
常见错误现象:
- 确认文件真实存在,但
Ctrl+P搜不到、资源管理器里也空白 - 以为是 Git 或操作系统搞的鬼,其实只是
files.exclude在生效
解决方法很简单:打开 Preferences: Open Workspace Settings (JSON),删掉或注释掉 "**/.*": true 这一行。如果只想放行特定点文件(比如保留 .env 但继续隐藏 .DS_Store),就改成:
{
"files.exclude": {
"**/.DS_Store": true,
"**/.git/**": true
}
}
想隐藏但又不能删的私密文件(如 config.local.json)
这类文件通常有明确命名、不带点前缀,但内容敏感(比如含 API key、数据库密码),必须保留在磁盘上,又不想出现在侧边栏干扰视线。
正确做法是用 glob 精确匹配路径:
-
"**/config.local.json": true→ 隐藏所有层级的同名文件 -
"src/configs/secrets.json": true→ 只隐藏根目录下该路径的文件(注意不加**/前缀) -
"**/*.local.*": true→ 匹配app.local.ts、db.local.yml等
别写成 "config.local.json"(只匹配根目录)、也别写 "*.local.*"(VSCode 不认这种无上下文的 glob)。路径必须相对于工作区根,且必须带 **/ 或明确路径前缀。
工作区设置 vs 用户设置:团队协作时别配错地方
私密文件的隐藏规则往往因项目而异:.env 在后端要隐藏,在前端 demo 项目里可能需要常看。这时候必须用工作区设置,而不是全局用户设置。
操作要点:
- 确保项目根目录下有
.vscode/settings.json;没有就手动建一个 - 完整写 JSON 对象,不要只贴一个字段(比如别只写
"files.exclude": {...}而不包在{}里) - 工作区配置会完全覆盖用户级同名配置,所以改了用户设置却没效果,大概率是项目里已有
.vscode/settings.json在起作用
提交 .vscode/settings.json 到 Git 是安全的——它只控制显示逻辑,不泄露任何文件内容。
files.exclude 和 search.exclude 完全是两回事
很多人以为配了 files.exclude,搜索时也会自动跳过那些文件,结果 Ctrl+Shift+F 还是扫到了 .env 里的密钥。这是因为:
-
files.exclude只管左侧资源管理器和Ctrl+P文件跳转列表 -
search.exclude才控制全局搜索范围,两者默认不联动
如果你既不想看到、也不想搜到某些私密文件,得两边都配:
{
"files.exclude": {
"**/.env": true,
"**/config.local.json": true
},
"search.exclude": {
"**/.env": true,
"**/config.local.json": true
}
}
临时排除搜索?直接点搜索框右上角的 files to exclude 输入框填路径更轻量,不污染配置。
最易忽略的一点:插件(比如 GitLens、DotENV)可能绕过 files.exclude 主动读取并展示被隐藏的文件。验证是否真隐藏成功,先禁用相关扩展再看侧边栏。











