Sublime Text 没有一键安装“精美暗黑主题”的通用方案——所谓“一键”，实际是三步：装对包、配对路径、禁用冲突项。错一步，界面就卡在半黑不黑状态。
Package Control 搜索时必须输对完整包名
很多人搜 One Dark 或 Dracula 装错包，结果只拿到配色方案（.tmTheme），UI 还是默认浅灰。真正能“全黑”的整合主题，包名带明确分隔符和空格：
-
Theme - One Dark（注意中间是短横+空格，不是OneDark或One Dark Theme） -
Material Theme（无短横，但大小写敏感；别选Material Theme UI这类过时分支） -
Theme - Soda（ST4 兼容版，文件夹名必须含空格和短横）
装完不生效？先去 Preferences → Browse Packages 确认文件夹名是否和 Package Control 安装后生成的完全一致——多一个下划线、少一个空格，"theme" 配置就静默失败。
Settings – User 里两行配置缺一不可
装完只是复制文件，不写配置等于没装。必须手动进 Preferences → Settings – User，补全且仅补全这两行：
{
"color_scheme": "Packages/Theme - One Dark/One Dark.tmTheme",
"theme": "One Dark.sublime-theme"
}常见错误：
- 路径漏掉
Packages/前缀 → 语法高亮不生效 - 扩展名写成
.sublime-color-scheme（这是 ST4 新格式，One Dark.tmTheme不兼容） - 引号用中文全角 → JSON 解析失败，整个设置回退到默认
- 加了
"one_dark_sublime_text_2": true→ ST4/ST3 直接忽略甚至报错
侧边栏/标签页颜色不对？大概率是其他插件或主题在抢控制权
你看到的“UI 半黑”，往往不是主题没装好，而是被覆盖了：
- 已启用
Adaptive或Default主题？它们会无视"theme"设置，必须先在命令面板中执行UI: Select Theme切换过去 - 装了
SideBarEnhancements或Origami？它们默认重绘侧边栏，需在各自插件设置里关掉"draw_sidebar_arrows"或设为false - 用了
FileIcons但没开？图标还是方块，视觉上就不协调；加一行"file_icons": true并重启
Material Theme 和 ayu 支持子变体（如 Material-Theme-Darker、ayu-mirage），但必须通过命令面板 UI: Select Theme 手动选，不能靠改配置文件名触发。
想调出纯黑背景？别碰 color_scheme，改 theme 文件本身
所有内置或第三方配色方案（Mariana、Monokai、Dracula.tmTheme）的编辑区背景都不是 #000000，而是深灰（如 #1e1e1e 或 #282c34）。真要纯黑，得改 UI 主题文件：
- 进
Packages/Theme - One Dark/One Dark.sublime-theme - 搜
"class": "overlay_control"或"class": "tabset_control" - 加
"layer0.tint": [0, 0, 0]和"layer0.opacity": 1.0
改完必须重启 Sublime Text——缓存不刷新，修改不加载。这类改动不推荐新手直接上手，因为 UI 主题是 JSON+嵌套对象结构，少个逗号就整个主题失效，且无法回滚。
