装完主题没变化，90%是因未正确配置Settings–User：必须同时严格填写"theme"（含正确后缀、大小写、空格）和"color_scheme"（以Packages/开头、路径精准），且重启生效；推荐用Material Theme: Activate theme命令自动配置。
装完主题没变化？90% 是没写对 Settings – User
Sublime Text 不会自动启用任何 UI 主题或配色方案，Package Control 只负责把文件下载到 Packages/ 目录，不会改配置。必须手动编辑 Preferences → Settings – User，填入严格匹配的 "theme" 和 "color_scheme" 字段，再重启才生效。
常见错误包括：
-
"theme": "Material Theme"→ 错，正确是"Material-Theme.sublime-theme"（含连字符、大小写、后缀） -
"color_scheme": "ayu-mirage.tmTheme"→ 错，缺Packages/前缀，应为"Packages/ayu/ayu-mirage.tmTheme" - 只配了
theme没配color_scheme→ 编辑区回退成纯黑底，UI 变了但代码看着像“失明”
Material Theme 激活命令比手动配更稳
用命令面板运行 Material Theme: Activate theme 是最省事的方式——它会自动写入正确的 theme、color_scheme，还顺带启用图标支持（如果已装 A File Icon）。
手动配容易漏细节：
- 路径中空格不能替换成下划线或连字符（
"Material Theme"文件夹名含空格，不是MaterialTheme） -
color_scheme路径里的schemes/子目录名必须小写，且不能拼错（如schema/或themes/都无效） - ST4 对 JSON 格式更敏感，多一个逗号或少一个引号会导致整个设置失效，界面退回默认灰白
图标不显示？检查 icon_theme 和重启
UI 主题变漂亮了，但侧边栏还是默认文件夹图标？大概率是没装或没配图标插件。
必须同时满足三件事：
- 通过 Package Control 安装
A File Icon（注意大小写，不是a file icon或FileIcons） - 在
Settings – User中添加"icon_theme": "A File Icon"（值必须与 Package 名完全一致） - 安装完图标插件后，**必须关闭并重新打开 Sublime Text** —— 缓存不刷新，图标永远不会渲染
如果已装多个图标插件（比如 File Icons 和 A File Icon），它们会冲突，只留一个启用即可。
Boxy / Agila / ayu 等主题的路径陷阱
这些主题都要求 theme 和 color_scheme 必须成对出现，且路径细节极易出错：
-
Boxy Ocean.sublime-theme对应的配色必须是"Packages/Boxy Theme/schemes/Boxy Ocean.tmTheme"，不能混用Boxy Monokai的 theme 和Boxy Ocean的 scheme -
ayu-mirage.tmTheme是文件名，不是ayu-mirage.sublime-color-scheme（后者是旧格式，ST4 不认） - 从 GitHub 手动安装时，文件夹名必须原样保留空格和大小写（如
Agila Theme），放进Packages/后路径必须是Packages/Agila Theme/Agila-Theme.sublime-theme
最保险的做法：装完后用命令面板执行 UI: Select Theme 和 Color Scheme，点开对应项，右下角状态栏显示的路径就是能直接复制粘贴的准确值。
