Sublime侧边栏不显示文件主因是未加载文件夹或配置错误:仅支持Open Folder项目模式,挂载路径、符号链接默认被跳过;file_exclude_patterns需用glob匹配(如*.env),项目配置优先级高于全局;show_hidden_files仅ST4有效,插件可能干扰原生行为。

侧边栏不显示文件?先确认是不是根本没加载文件夹
Sublime 的侧边栏天然不显示单个文件——你用 File → Open File… 打开一个 .py,侧边栏就是空的。它只在项目上下文里工作。
- 必须用
File → Open Folder…或已加载.sublime-project,folders配置才会生效 - macOS/WSL2 下挂载路径(如
/mnt/c/Users/xxx、APFS 快照卷)可能被 Sublime 静默跳过,侧边栏为空但无报错 - 符号链接(symlink)默认不跟随,即使目标是普通文件,也不会出现在侧边栏中
用 file_exclude_patterns 隐藏特定后缀文件
这是最常用也最容易出错的方式。它不是“黑名单”,而是“主动排除列表”——你列什么,就藏什么,漏一个,它就冒出来。
- 只支持 glob 风格匹配:
*.log有效,^\.或.env(不带通配符)无效;.env要写成.env或*.env才能命中 -
*是贪婪前缀匹配:*.min.js匹配main.min.js,但不匹配min.js - 项目级配置优先级高于全局设置,且完全覆盖,不是合并:你在用户设置里删了
node_modules,但项目配置里还写着,它就还在 - 示例(仅当前项目):
{ "folders": [ { "path": ".", "file_exclude_patterns": ["*.log", "*.tmp", "*.pyc", "*~", "*.swp"] } ] }
想“只显示 .py 和 .md”?得反向排除所有其他类型
Sublime 没有 show_only_patterns 这种白名单机制,只能靠“排除非目标项”逼近效果。
- 必须用项目配置(
.sublime-project),全局设置会误杀其他项目 - 容易漏掉临时文件:
*~、.swp、.DS_Store、.gitignore都得单独列 - 常见遗漏:
*.min.js不等于*.js;*.jpg不含*.jpeg;*.md不含*.markdown - 别写
"*"或".*"—— Sublime 不支持这种通配,写了等于没写
show_hidden_files 是开关,但 ST3 完全无效
如果你发现改了 file_exclude_patterns 还是看不到 .env 或 .gitignore,大概率卡在这儿:这个功能从 Sublime Text 4 build 4126 才正式支持。
- ST3 用户无论怎么加
"show_hidden_files": true,都无效——升级是硬性前提 - 该设置需加在用户设置或项目
settings字段下,不是直接塞进folders里 - 即使开了
show_hidden_files,如果folder_exclude_patterns里还留着".git",.git文件夹依然不会出现 - 插件(如
SideBarEnhancements)可能覆盖原生行为,临时禁用可验证是否为插件干扰










