侧边栏未显示的首要原因是被隐藏或拖窄而非主题问题,应先用ctrl+k松开再按ctrl+b(windows/linux)或cmd+k松开再按cmd+b(macos)切换,同时检查是否误启mini sidebar、项目未加载文件夹、folder_exclude_patterns配置错误、图标插件与主题不匹配、菜单栏被隐藏等情况。

侧边栏根本没出来?先确认是否被隐藏或压扁
安装新主题后侧边栏“消失”,90% 不是主题导致的,而是状态被意外切换或拖窄。Sublime 的侧边栏不会因换主题而自动关闭,但新主题可能改变视觉反馈(比如背景色与编辑区接近),让人误以为不见了。
先试快捷键:Ctrl+K 松开再按 Ctrl+B(Windows/Linux)或 Cmd+K 松开再按 Cmd+B(macOS)。这不是四键齐按,顺序和松手动作必须准确。
- 如果没反应,点一下编辑区确保 Sublime 窗口获得焦点
- 输入法(如搜狗、QQ拼音)常劫持
Ctrl+K,临时切英文输入法再试 - 鼠标移到编辑区最左边缘,光标变成
↔时向右拖动——它可能被拖窄到 1–2 像素宽,肉眼不可见 - 拖不动?右键侧边栏空白处 → 取消勾选
Mini Sidebar
侧边栏出来了但空着?检查项目加载和排除规则
新主题不影响项目逻辑,但容易让人忽略:侧边栏只显示当前项目结构,不自动挂载单个文件所在目录。装完主题后若只用 File → Open File 打开一个 main.py,侧边栏必然为空——这是设计,不是 bug。
- 正确做法:用
File → Open Folder…(Windows/Linux)或File → Open…并选中整个文件夹(macOS) - 想追加路径而非重置项目:按
Ctrl+Shift+P输入Project: Add Folder to Project回车 - 误用
Open Folder…会清空所有已有路径,之前加的文件夹全丢 - 检查用户设置里有没有
"project": null这行,有就删掉,否则项目上下文被强制清零
更隐蔽的问题是 folder_exclude_patterns 配置写崩了。例如 "folder_exclude_patterns": ["*"] 或 ["."] 会把整个项目结构过滤掉,展开后连 node_modules 都不见。临时验证:在 Preferences → Settings 用户设置中给这行加 // 注释,保存后按 Ctrl+K, Ctrl+B 刷新视图。
图标显示异常或完全空白?主题和插件没对齐
很多用户装了 A File Icon 之类插件又换了主题,结果图标全无——根本原因不是插件失效,而是主题没定义 icon_folder 或 icon_file_type 这类 CSS class 规则。A File Icon 只负责往 DOM 注入 class,不负责画图。
- 必须切换到明确支持的 theme,比如
AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme;别用 Material、AYU 等第三方主题凑合,它们常漏映射 - 检查
ignored_packages是否误加了"Default"或"Theme - Default",这会让所有主题资源加载失败 - 插件安装或升级后必须手动运行
A File Icon: Rebuild Icons(命令面板输入),否则 SVG 资源未下载,class 挂上了也渲染不出图形 - ST 版本低于
4.4192会导致 class 注入机制不全,旧版v2.x插件在 ST4 下大概率失效
菜单栏也不见了?别和侧边栏问题混为一谈
有时候你以为侧边栏丢了,其实是菜单栏被隐藏了——右上角看不到 View → Side Bar 菜单项,Ctrl+K, Ctrl+B 就找不到入口。
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)输入 View: Toggle Menu 回车,立刻恢复菜单栏。这个操作独立于侧边栏状态,也和主题无关。
真正容易被忽略的是:Sublime 没有“全局文件浏览器”概念,一切以项目为中心。哪怕你刚装完一个炫酷主题,只要没加载文件夹作为项目,侧边栏就是空的——这点和 VS Code 完全不同,得适应。











