sublime text 侧边栏显示隐藏文件需满足三条件:st4 build 4126+、启用 show_hidden_files、清除 folder_exclude_patterns 和 file_exclude_patterns 中的显式排除项。

Sublime Text 侧边栏默认不显示以点号开头的文件和文件夹(如 .git、.env、.prettierrc),这不是配置缺失,而是硬编码行为——即使系统设置“显示隐藏文件”,它也完全无视。要让这些项出现,必须同时满足三个条件:ST4 build 4126+、启用 show_hidden_files、并清理掉 folder_exclude_patterns 和 file_exclude_patterns 中的显式排除项。
确认 Sublime Text 版本是否支持 show_hidden_files
ST3 完全不识别 show_hidden_files,无论怎么配都无效。必须是 Sublime Text 4 build 4126 或更高版本(2026 年当前稳定版均已满足)。验证方式:Help → About,看 Build 号是否 ≥ 4126。低于这个数,"show_hidden_files": true 这行会被静默忽略,不报错也不生效。
在正确位置添加 show_hidden_files 设置
该选项必须放在用户设置(Preferences → Settings 右侧面板)的顶层 settings 字段下,不能嵌套在 folders 或 project_settings 里。否则只对当前项目生效,且容易因加载方式失效。
正确写法示例:
{
"show_hidden_files": true,
"folder_exclude_patterns": ["node_modules", "__pycache__"],
"file_exclude_patterns": ["*.pyc", "*.log"]
}
注意:folder_exclude_patterns 和 file_exclude_patterns 默认包含 "\.git"、"\.DS_Store" 等,它们会继续屏蔽对应项——哪怕 show_hidden_files 已开启。所以你得手动删掉这些具体条目,否则 .git 依然不会出现。
folder_exclude_patterns 写错会导致整个侧边栏为空
常见错误是误用通配符或模糊匹配:
-
"*"会匹配所有目录名,导致整个项目根目录被过滤,侧边栏变空 -
"."会匹配所有以点开头的目录(包括.git、.vscode),甚至可能误杀项目本身 - Sublime 不支持正则,
"^\."或".*"无效;只支持 glob 前缀匹配,比如"*.tmp"有效,但"."不是合法前缀
安全做法是只列明确要隐藏的项,例如:
"folder_exclude_patterns": ["node_modules", "__pycache__", ".idea"], "file_exclude_patterns": ["*.pyc", ".DS_Store"]
如果你只是临时调试,可先注释掉整行 folder_exclude_patterns,重启 Sublime 后观察是否恢复。
加载项目的方式决定配置是否起作用
仅用 File → Open File… 打开单个文件时,侧边栏天然为空——Sublime 不会推导父目录,也不会读取任何项目级配置。必须用以下任一方式加载:
-
File → Open Folder…(但会清空已有项目) -
Project → Add Folder to Project(推荐,叠加添加,不破坏现有结构) - 双击已有的
.sublime-project文件
如果用了 Project → Edit Project,show_hidden_files 也必须加到 project 的 settings 字段下,否则不生效。另外,改完设置后无需重启整个应用,关闭再重新打开项目即可刷新侧边栏。
最常被忽略的一点:show_hidden_files 是总开关,但它不绕过 folder_exclude_patterns 的显式条目。很多人配了 true 却看不到 .git,第一反应是配置没生效,其实只是忘了删掉 "\.git" 这一行。











