one dark 在 sublime text 中需同时正确安装 ui 主题和配色方案,且路径、大小写、扩展名必须完全匹配,否则仅部分生效或静默回退默认主题。

One Dark 在 Sublime Text 里不会“装完就黑”,必须同时配对 UI 主题和配色方案,且路径、大小写、扩展名全对,缺一不可。
安装时搜错包名:Theme - One Dark 才是正解
Package Control 中搜 One Dark 会出来一堆名字近似的包,但只有 Theme - One Dark(注意中间是空格 + 短横)才是官方适配 Sublime 的完整主题包。其他如 One Dark Theme、OneDark、One Dark Color Scheme 都只提供部分功能,装了也白搭。
- 装
One Dark Color Scheme→ 只有代码区变暗,侧边栏/标签页仍是默认浅灰 - 装
OneDark(无空格短横)→ 多为 VSCode 移植版,Sublime 加载失败或颜色错乱 - 装完不重启 Sublime,或重启后没手动配置,主题也不会生效
用户设置里这两行必须精确写对
Preferences → Settings – User 里必须手动加这两行,不能靠菜单点选——菜单有时会漏掉路径或写错大小写:
"color_scheme": "Packages/Theme - One Dark/One Dark.tmTheme", "theme": "One Dark.sublime-theme"
常见错误包括:
-
Packages/写成packages/或Packages\(反斜杠 Windows 下也不认) -
Theme - One Dark文件夹名和 Package Control 安装后生成的完全一致(可进 Preferences → Browse Packages 确认) -
One Dark.tmTheme误写为OneDark.tmTheme或One Dark.sublime-color-scheme(ST3/ST4 混用格式会失效) - 多加了
"one_dark_sublime_text_2": true—— 这行只对 ST2 有效,ST4 加了反而干扰加载
侧边栏发虚、图标小、颜色断层?不是主题问题
One Dark 主题本身不控制侧边栏字体大小、文件图标、折叠箭头样式。你看到的“半生效”,大概率是 UI 主题启用了,但底层渲染参数没同步:
- 在 Settings – User 里加
"font_size": 12和"tree_animation_enabled": false,立刻改善可读性和视觉抖动 - 文件图标还是方块?那是没装
FileIcons插件。装完后加"file_icons": true - 如果同时启用了
Adaptive或Material Theme,它们会覆盖"theme"设置,得先禁用 - 某些插件(如
SideBarEnhancements)会重绘侧边栏,需查其设置里是否开了"draw_sidebar_arrows"并设为false
配色高亮不精准?别直接改原文件
想调 keyword、string、comment 的颜色,不能直接编辑 Packages/Theme - One Dark/One Dark.tmTheme —— 这是只读文件,改了也不生效。
- 先按
Ctrl+Shift+P输入Show Scope Name,确认当前 color_scheme 路径 - 用
PackageResourceViewer导出原配色,或手动复制到Packages/User/下,重命名为One Dark Custom.tmTheme - 在 Settings – User 中显式指定:
"color_scheme": "Packages/User/One Dark Custom.tmTheme" - 修改时盯住
rules数组里的scope字段,比如keyword.control对应 if/for,string.quoted.double对应双引号字符串
最常被忽略的一点:Sublime 不报错,只静默回退到默认主题。路径错一个字母、引号用中文、JSON 少逗号,界面看起来“没变”,其实配置早失效了。检查一定要进 Packages/ 目录眼见为实。











