侧边栏图标存在但展开为空的主因是folder_exclude_patterns配置过宽，如["*"]或["."]会误排除全部目录；正确写法应明确列出需隐藏的目录如["node_modules", ".git"]。
侧边栏有图标但点开是空的？查 folder_exclude_patterns
这是最隐蔽的“静默故障”：文件夹明明加载成功、图标也挂着，一展开却空空如也，连 node_modules 都不见。根本原因几乎全是 folder_exclude_patterns 配置太宽泛。
- 危险写法：
"folder_exclude_patterns": ["*"]（匹配所有目录）、"folder_exclude_patterns": ["."]（匹配所有以点开头的路径，包括项目根目录本身） - 安全写法示例：
"folder_exclude_patterns": ["node_modules", ".git", "__pycache__", "venv"] -
"folder_exclude_patterns": [".*"]是可接受的，它只排除隐藏目录，不影响正常结构 - 临时验证：在
Preferences → Settings用户设置中，给整行加//注释掉，保存后按Ctrl+K Ctrl+B刷新视图即可看到效果
侧边栏根本没出来？先确认它是不是被压窄了
Sublime 的侧边栏极少真正“消失”，90% 情况是被拖到只剩 1–2 像素宽，肉眼看不见。
- 把鼠标移到编辑区最左侧边缘，光标变成
↔时向右拖动就能拉出 - 如果拖不动，右键侧边栏空白处 → 取消勾选
Mini Sidebar - 快捷键
Ctrl+K松开再按Ctrl+B（Windows/Linux）或Cmd+K松开再按Cmd+B（macOS）可强制切换显隐 - 快捷键无效时，先点一下编辑区确保窗口获得焦点；中文输入法可能劫持组合键，临时切英文输入法再试
侧边栏空着？你没加载项目，只打开了单个文件
Sublime 不会为 File → Open File 打开的单个 main.py 自动挂载其父目录——这不是 bug，是设计逻辑。侧边栏只显示「已加入项目的路径」。
- 正确做法：按
Ctrl+Shift+P输入Project: Add Folder to Project回车，选择你的代码根目录（不会清掉已有路径） - 慎用
File → Open Folder…：它会重置整个项目，之前加的所有文件夹全丢 - 检查用户设置里有没有
"project": null这行，有就删掉，否则项目上下文被清零 - 便携版若发现
subl .命令无效，本质是路径注册失败，不是快捷键问题
想让单个打开的文件也出现在侧边栏顶部？改两个配置项
默认情况下，通过 File → Open File 打开的日志、配置片段等独立文件不会进侧边栏。要让它露头，不需要插件。
- 在用户设置中加入：
"show_open_files": true - 顺手关掉预览模式：
"preview_on_click": false，否则单击侧边栏里的文件只是临时预览，关掉标签就消失 - 注意：
file_exclude_patterns控制文件过滤，folder_exclude_patterns控制目录是否显示，两者互不干扰
folder_exclude_patterns 错误配置不会报错，也不会提示，它只是让整个目录结构“静默消失”。很多人反复重装插件、重置设置，却漏掉这一行 JSON —— 它藏在用户设置里，不起眼，但杀伤力极强。
