Sublime安装主题必须同时配置theme和color_scheme，缺一不可；路径须严格匹配大小写、空格、Packages/前缀及扩展名，否则静默退回默认灰白界面。
Sublime 安装主题插件不是“装一个就变样”，必须同时配置 theme（UI 主题）和 color_scheme（代码配色），缺一不可；路径写错、大小写不对、漏掉 Packages/ 前缀，都会静默失败——界面看起来没反应，其实它早就悄悄退回默认灰白。
用 Package Control 装主题，别拖 ZIP 进 Packages 目录
手动解压扔文件进 Packages/ 是最容易出错的路：文件夹名多一个空格（Agila Theme ≠ AgilaTheme）、.sublime-theme 文件放错层级、大小写不匹配（Material-Theme.sublime-theme ≠ material-theme.sublime-theme），Sublime 就直接无视。
- 先确认
Package Control已装好：按Ctrl + `打开控制台，粘贴官网最新脚本（含sha256校验），执行后重启，再按Ctrl + Shift + P能搜到Package Control: Install Package才算成功 - 装主题统一走命令面板：按
Ctrl + Shift + P→ 输入Install Package→ 搜Material Theme、Ayu、Boxy Theme或Agila Theme，选中回车 - 装完不重启也能继续操作，但配置没写对就等于白装
必须手动填对 settings - user 里的 theme 和 color_scheme
Package Control 只负责把文件下到 Packages/ 目录，不会自动写配置。你得自己打开 Preferences → Settings – User，填两行 JSON —— 少一行、错一个字符，侧边栏或代码区就“掉皮”。
-
"theme"值必须是完整文件名，带.sublime-theme后缀，大小写、空格、连字符全要严丝合缝，比如："Boxy Ocean.sublime-theme"，不是boxyocean也不是BoxyOcean -
"color_scheme"必须以Packages/开头，路径里包名、子目录、文件名全部大小写敏感，比如："Packages/Boxy Theme/schemes/Boxy Ocean.tmTheme"，漏掉Packages/或写成packages/（小写）就加载失败 - 最稳的路径来源不是网上抄，而是按
Ctrl + Shift + P→UI: Select Theme看带 ✔️ 的项，再Color Scheme看状态栏右下角显示的路径 —— 那才是你本地真实生效的路径
这几套配色方案实测护眼，但启用方式各不相同
所谓“护眼”，不是调暗就行，关键在背景明度差（建议 40–45%）、避开 450–495nm 高饱和青蓝，且 UI 与代码区风格统一。Ayu Mirage、Espresso Libre、Deep Ocean 是目前 ST4 下最稳的三套，但启用逻辑不同：
-
Ayu Mirage：装完Ayu包后，必须手动选UI: Select Theme → Ayu.sublime-theme+Color Scheme → Ayu → Ayu Mirage，路径是"Packages/Ayu/schemes/ayu-mirage.tmTheme"；只装不选，UI 还是默认 Adaptive -
Espresso Libre：属于Dayle Rees Color Schemes包，装完直接从Color Scheme菜单里选，不用额外配theme；但它不自带 UI 主题，得搭配Material Theme或Soda才完整 -
Deep Ocean：轻量级独立配色，装完即用，但注意它只有.tmTheme格式，ST4 下若加载失败，说明你装的是旧版（需确认包里已提供.sublime-color-scheme）
侧边栏图标、字体、背景同步这些细节容易被跳过
装完主题发现侧边栏还是纯文字、标签页没圆角、状态栏颜色和编辑区割裂——这不是主题没生效，是配套没跟上。
- 文件图标靠
A File Icon插件：同样用Package Control装，装完立刻生效；若已有其他图标插件（如File Icons），得禁用冲突项 - 侧边栏字体太小？在
Settings – User里加："font_size": 12、"tree_animation_enabled": true，别去改.sublime-theme源文件——升级会被冲掉，JSON 格式错一个逗号整个 UI 就挂 - Material Theme 类主题默认不开启侧边栏背景同步，得额外加：
"material_theme_background_panel": true，否则编辑区是深灰，侧边栏还是惨白
真正卡住人的从来不是“怎么装”，而是路径里那个空格、大小写、斜杠方向，或者忘了重启窗口让侧边栏重绘；配色方案看着美，但没配对 theme，UI 就永远是割裂的。
