侧边栏显示但为空,主因是folder_exclude_patterns配置错误、项目未正确加载或侧边栏被拖窄至不可见;需检查排除规则、用add folder to project追加路径,并拖动边缘恢复宽度。

侧边栏显示了但里面空着,不是插件没装、也不是 Sublime 崩了,而是它压根没东西可展示——folder_exclude_patterns 配置错、项目没加载对、或被拖窄到只剩一条线,三者占 95% 以上。
侧边栏有图标但点开啥都没有?查 folder_exclude_patterns
这是最隐蔽也最常见的“静默故障”:文件夹明明加进来了,图标也挂着,一展开却空空如也,连 node_modules 都不见。根本原因几乎全是用户设置里那行 folder_exclude_patterns 写崩了。
- 危险写法:
"folder_exclude_patterns": ["*"](匹配所有目录名)、"folder_exclude_patterns": ["."](匹配所有以点开头的路径,包括项目根目录本身) - 安全写法示例:
"folder_exclude_patterns": ["*.pyc", "node_modules", "__pycache__", ".git"] - 临时验证:在 Preferences → Settings 用户设置中,给整行加
//注释掉,保存后按Ctrl+K, Ctrl+B刷新视图 -
"folder_exclude_patterns": [".*"]是可接受的,它只排除隐藏目录,不影响正常结构
加了文件夹还是空?你可能误用了 File → Open Folder…
这个菜单项不是“添加”,是“重置”。点一次,之前所有已加入的路径全丢,只留新选的那个文件夹——甚至可能一闪就空,因为新路径下没符合显示条件的子项。
- 正确追加方式:
Ctrl+Shift+P→ 输入Project: Add Folder to Project→ 回车选择目录 - 如果命令面板里搜不到该命令,检查用户设置里有没有
"project": null这行,有就删掉 - 便携版用户若发现
subl .命令无效,Add Folder to Project也可能不响应,本质是路径注册失败,不是快捷键问题 - 想让多目录结构跨会话保留?必须执行
Project → Save Project As…,生成一个.sublime-project文件
侧边栏“看不见”但其实还在?试试拖出来
这不是 Bug,是视觉陷阱。很多人以为侧边栏“消失”了,其实是被鼠标拖到了最左边界,宽度缩到 1–2 像素,肉眼几乎不可见。
- 把鼠标移到编辑区最左侧边缘,光标变成左右双向箭头
↔时,按住向右拖动即可拉出 - 如果拖不动,右键侧边栏空白处 → 取消勾选
Mini Sidebar - 按
Ctrl+K, Ctrl+B没反应?先试试拖——它没被隐藏,只是被“压扁”了 - 部分笔记本需配合
Fn键才能触发Ctrl+B,别漏掉这个物理层干扰
单个文件怎么进侧边栏?关掉预览模式 + 开启显示开关
默认情况下,直接打开的单个文件(比如双击 main.py)不会自动出现在侧边栏,哪怕你已加载了项目。这不是遗漏,是设计逻辑:Sublime 不推导上下文。
- 在用户设置中加入:
"preview_on_click": false(否则单击只是临时预览,标签页闪一下就变灰) - 顺手加上:
"show_open_files": true(这样当前打开的文件会在侧边栏顶部以 “Open Files” 分组形式显示) - 这两个设置必须同时生效才有用;只改一个,效果几乎为零
- 注意:
show_open_files不影响项目结构树,只控制已打开文件的聚合展示
真正难搞的从来不是“怎么调出来”,而是“为什么调出来却空着”——folder_exclude_patterns 的匹配行为、Open Folder… 和 Add Folder to Project 的语义差异、以及 preview_on_click 对交互反馈的隐式劫持,这三处最容易被当成“小设置”忽略,结果卡住一整天。











