sublime text 侧边栏不显示隐藏文件需满足三条件:一是必须使用st4 build 4126+版本;二是show_hidden_files: true须置于顶层settings字段,不可在folders内;三是需通过“open folder”加载项目,且检查folder_exclude_patterns是否误含.git等。

侧边栏不显示 .git 等隐藏文件?先确认你用的是 Sublime Text 4
ST3 完全不支持 show_hidden_files,无论怎么配都无效。必须升级到 ST4 build 4126 或更高版本(2026 年当前最新稳定版已满足)。如果你改了设置却看不到 .git、.env 或 .prettierrc,第一反应不是配置错,而是版本不够。
验证方式:菜单 → Help → About,看 Build 号是否 ≥ 4126。低于这个数,"show_hidden_files": true 这行直接被忽略,不会报错,也不会生效。
show_hidden_files 必须加在 settings 字段下,不能塞进 folders
很多人把 "show_hidden_files": true 写进 folders 数组里,比如:
{
"folders": [
{
"path": ".",
"show_hidden_files": true // ❌ 错误位置,完全无效
}
]
}
正确写法是把它放在项目配置的顶层 settings 字段中:
{
"folders": [
{
"path": "."
}
],
"settings": {
"show_hidden_files": true // ✅ 正确位置
}
}
同样适用于用户设置(Preferences → Settings 右侧)——也必须放在根级 JSON 对象里,不能嵌套进其他字段。
folder_exclude_patterns 和 file_exclude_patterns 是“额外过滤”,不是开关
开了 show_hidden_files 后,.git 依然不出现?大概率是因为 folder_exclude_patterns 里还留着 ".git"。
-
folder_exclude_patterns只对目录名生效:"node_modules"、".git"、"__pycache__"都该放这里 -
file_exclude_patterns只对文件名生效:"*.log"、".env"、"*.pyc"才该放这里 - 二者都不支持正则:
"^\."、".*"、"**/*.md"全部无效,只认 glob 前缀匹配(如"*.tmp"有效,"tmp"会误杀atmp.js) - 数组不合并:项目配置里写了
"folder_exclude_patterns": [".git"],那全局设置里的同名字段就彻底失效
侧边栏为空?可能根本没加载项目目录
用 File → Open File… 打开单个 index.js,侧边栏天然为空——这不是 bug,是设计。Sublime 的侧边栏只响应「项目上下文」。
必须通过以下任一方式加载目录结构:
-
File → Open Folder…(Windows/Linux) -
File → Open…并选中一个文件夹(macOS) - 已有
.sublime-project文件,双击打开或用Project → Open Project…
另外注意两个静默失败点:
- 路径含符号链接(symlink):默认不跟随,目标目录再正常也不会出现
- 挂载路径(如 WSL2 的
/mnt/c/Users/xxx、macOS APFS 快照卷):Sublime 可能静默跳过,无错误提示,侧边栏就是空的
真正容易被忽略的是:即使所有配置都对,只要没走「Open Folder」这一步,show_hidden_files 就永远没机会起作用。











