VSCode中隐藏文件由files.exclude规则主动过滤而非系统属性,需编辑工作区JSON删除或覆盖"**/.*": true并重开文件夹生效;search.exclude须单独配置且与files.exclude完全独立。

VSCode 里“隐藏文件”不是系统级设置,而是 files.exclude 规则主动过滤的结果;取消隐藏,本质是删掉或覆盖那条默认的 "**/.*": true 规则。
为什么改了设置还是看不到 .env、.git、.vscode?
VSCode 不读操作系统“隐藏属性”,它靠 files.exclude 决定资源管理器里显示什么。默认规则 "**/.*": true 会匹配所有路径下以点(.)开头的文件和文件夹——所以 .env、.git、.vscode 全被拦在门外,哪怕你在 Finder 或资源管理器里手动设为可见也没用。
- 必须直接编辑 JSON 设置,GUI 界面点开关无效
- 工作区设置(
.vscode/settings.json)优先级高于用户设置,很多人改了全局却没效果,就是因为项目里已有工作区配置 - 改完保存后,必须关闭再重新打开当前文件夹(
File > Close Folder → File > Open Folder),仅刷新窗口或重启 VSCode 不生效
怎么安全地取消隐藏(只放行需要的)?
不建议直接删掉整条 "**/.*": true——这会让 .DS_Store、.gitignore、.editorconfig 全部涌出来,干扰视觉。更稳妥的做法是显式放行特定项:
- 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),运行Preferences: Open Workspace Settings (JSON) - 找到
"files.exclude"对象,把它改成类似这样:
"files.exclude": {
"**/.DS_Store": true,
"**/.git/**": true,
"**/.vscode/**": true,
"**/.*": false
}
注意:"**/.*": false 要写在最后(顺序无关,但逻辑上更清晰),表示“除上面明确排除的之外,其余点文件都显示”。
为什么 .env 显示了,但 Ctrl+Shift+F 搜不到?
files.exclude 和 search.exclude 是两套完全独立的系统:
-
files.exclude控制左侧资源管理器 +Ctrl+P文件跳转列表 -
search.exclude只管全局搜索(Ctrl+Shift+F)是否包含某路径 - 即使你已让
.env在资源管理器可见,如果search.exclude里还有"**/.env": true或"**/.*": true,它依然不会出现在搜索结果中
解决方法:同样在 workspace settings JSON 中,添加或修改 search.exclude:
"search.exclude": {
"**/.DS_Store": true,
"**/.git/**": true,
"**/.*": false
}
远程开发(Remote-SSH)时隐藏文件不生效?
通过 Remote-SSH 连接 Linux/macOS 主机时,files.exclude 的修改必须作用于远程端设置,而非本地:
- 连接成功后,在远程窗口中执行
Preferences: Open Remote Settings (JSON) - 编辑的是远程主机上的配置(实际路径类似
~/.vscode-server/data/Machine/settings.json,不可见但生效) - 不要试图在本地改——那只会控制本地窗口行为,对远程文件树完全无效
- 改完仍需关闭并重开远程文件夹才能刷新资源管理器
最常被忽略的一点:files.exclude 和 search.exclude 必须在同一个作用域(用户 / 工作区 / 远程)下配对修改,且每次变更后都得重新加载文件夹——这个“重新加载”动作不是可选项,是硬性前提。











