sublime侧边栏“消失”主因是被隐藏或拖窄，非主题问题；中文乱码需设"font_options": ["gdi"]；图标不显因主题未定义对应css类；theme/color_scheme路径须严格匹配大小写及后缀。
侧边栏空白或“消失”不是主题问题，是状态被切掉或拖窄了
装完新主题后侧边栏没出来，90% 不是主题导致的。Sublime 的侧边栏不会因换主题自动隐藏，但视觉变化（比如背景色和编辑区接近）容易让人误判。先确认它是不是被手动关了或压扁了：
- 按
Ctrl+K松开，再按Ctrl+B（Windows/Linux）或Cmd+K松开再按Cmd+B（macOS）——注意不是四键齐按，顺序和松手动作必须准确 - 输入法（如搜狗、QQ拼音）常劫持
Ctrl+K，临时切英文输入法再试 - 鼠标移到编辑区最左边缘，光标变成
↔时向右拖动——它可能被拖窄到 1–2 像素宽，肉眼不可见 - 拖不动？右键侧边栏空白处 → 取消勾选
Mini Sidebar
侧边栏有内容但中文显示异常，font_options 必须设为 ["gdi"]
中文乱码、繁体混入、字体发虚，根本原因是 Windows 下 DirectWrite 渲染引擎对中文字形映射出错。font_options 是唯一能切换渲染方式的开关，不加这行，改字体、调 dpi_scale 都白搭：
- 打开
Preferences → Settings，在右侧用户设置里添加："font_options": ["gdi"] - 这行必须单独存在，不能和其他字段挤在一行；末尾不要逗号（尤其前面已有其他配置时）
- 加完保存，
Ctrl+K,Ctrl+B刷新视图即可生效，不用重启 - 若想同步调整字体，可追加
"font_face": "Consolas"或你喜欢的等宽字体
图标不显示或全空白，主题没定义对应 CSS class
A File Icon 这类插件只负责往 DOM 注入 icon_folder、icon_file_type 等 class，画图靠的是主题里的 CSS 规则。很多第三方主题（如 Material、AYU）压根没写这些 class 的样式，结果图标就消失了：
- 别用通用主题凑合，换明确支持图标的 theme，例如
AFileIcon Dark.sublime-theme - 检查
ignored_packages是否误加了"Default"或"Theme - Default"，这会直接禁用基础 UI 渲染 - 手动验证：打开
Preferences → Customize Theme，搜索icon_folder，看有没有对应 rule；没有就说明主题不兼容
theme 和 color_scheme 路径写错，UI 和代码区各变一半
主题不生效、配色失效、状态栏路径和配置文件对不上，几乎全是路径细节翻车：
-
theme值必须带.sublime-theme后缀，color_scheme必须是.tmTheme或.sublime-color-scheme，二者不能混用 - 路径必须以
Packages/开头，大小写敏感——Packages/Material Theme/schemes/Material-Theme-Ocean.tmTheme错一个空格或大小写就加载失败 - 最稳妥办法：先用菜单
UI: Select Theme和Color Scheme各选一次，看状态栏实时显示的完整路径，复制粘贴进设置 - Material Theme 等复杂主题需额外运行
Material Theme: Activate theme命令，否则只改了标签页，侧边栏还是默认样式
真正卡住人的从来不是功能本身，而是 font_options 漏加、路径大小写错、图标 class 没映射这三处——它们不报错，只静默失效，得一个个去碰。
