侧边栏根本没显示是因为未进入项目模式;sublime只渲染已加载项目的结构,需通过file→open folder…加载文件夹,而非打开单个文件,并检查左下角是否有路径提示及用户设置中是否误写"project": null。

侧边栏根本没显示?先确认是否处于项目模式
Sublime 的侧边栏不是文件管理器,它只渲染已加载的项目(Project)结构。用 Ctrl+O 打开单个文件、或直接双击文件启动 Sublime,侧边栏默认就是空的——这不是 bug,是设计逻辑。必须让 Sublime 进入“项目模式”,它才会开始构建目录树。
判断是否已进项目模式:看左下角状态栏有没有类似 ~/my-project/ 或 src/ 这样的路径提示;没有,说明还没加载任何文件夹。
- 正确做法是:
File → Open Folder…(Windows/Linux)或File → Open…并选中整个文件夹(macOS) - 错误做法是:
File → Open File或拖一个.py文件进来——这不会挂载父目录 - 如果已打开多个文件夹但侧边栏突然清空,检查用户设置里是否误写了
"project": null,这行会强制清空全部上下文
快捷键 Ctrl+K, Ctrl+B 没反应?别按错顺序和状态
这个组合键是切换显隐,不是“开启”功能,且必须分两步按:Ctrl+K → 松开 → Ctrl+B(macOS 是 Cmd+K → Cmd+B)。很多人卡在同时按四个键,或者窗口没激活。
- 确保 Sublime 窗口被激活:点一下编辑区或标题栏再试
- 检查菜单栏是否被隐藏:按
Ctrl+Shift+P输入View: Toggle Menu回车恢复 - 验证快捷键是否绑定成功:按
Ctrl+`打开控制台,输入sublime.log_commands(True),再按组合键,看是否打印toggle_side_bar - 没打印?可能是插件(如 Origami)覆盖了命令,或键盘需加
Fn键(部分笔记本)
侧边栏显示但目录为空?检查 folder_exclude_patterns 和加载方式
图标在侧边栏里,点开却一片空白,常见原因是 folder_exclude_patterns 配置太宽泛,或者用了 File → Open Folder… 而非 Project: Add Folder to Project。
- 打开
Preferences → Settings,检查右侧用户设置中的folder_exclude_patterns - 危险写法:
["*"]、["."]、["**"]—— 这些会匹配并隐藏整个根目录 - 安全写法示例:
"folder_exclude_patterns": [".git", "node_modules", "__pycache__", ".DS_Store"] - 若想叠加添加目录(不丢已有路径),必须用命令面板:
Ctrl+Shift+P→ 输入Project: Add Folder to Project→ 回车选择
关掉再开就没了?.sublime-project 是唯一持久化方案
用 Project: Add Folder to Project 加的路径只是内存级挂载,退出即丢。真正能“记住项目”的,只有保存为 .sublime-project 文件。
- 执行
Project → Save Project As…,生成一个带"folders"字段的 JSON 文件 - 确保用户设置里有:
"remember_open_files": true和"hot_exit": true - 便携版用户注意:
subl .命令失效时,Add Folder to Project也可能不响应——本质是路径注册失败,不是快捷键问题
侧边栏本身没有“完整路径显示”能力,这是内核硬编码限制;想定位当前文件,按 F12 即可聚焦到侧边栏对应项——前提是该文件属于已加载的文件夹,否则它本就不该出现在那里。











