one dark 主题在 sublime text 中需同时配置 ui 主题（one dark.sublime-theme）和配色方案（one dark.tmtheme），路径、大小写、扩展名必须精确，且依赖 st3.3+；vscode 的 one dark pro 不兼容，侧边栏与图标需额外安装字体及 fileicons 插件。
One Dark 主题在 Sublime Text 里不是“装完就生效”的单体包
很多人按常规流程装完 Theme - One Dark，重启后发现侧边栏还是浅灰、标签页没变暗、状态栏颜色不对——这不是安装失败，而是 Sublime 的主题系统分两层：UI 主题（控制菜单/侧边栏/标签）和配色方案（控制代码编辑区）。One Dark 在 Sublime 中实际是两个独立组件：One Dark.sublime-theme（UI） + One Dark.tmTheme（语法高亮），必须**同时配置且路径准确**才完整生效。
- 用 Package Control 安装时，搜索
Theme - One Dark（注意中间有空格和短横），别选错成One Dark Theme或OneDark（后者多为 VSCode 移植版，Sublime 不兼容） - 安装后不会自动启用，必须手动进
Preferences → Settings - User，写入两行关键配置：
{
"color_scheme": "Packages/Theme - One Dark/One Dark.tmTheme",
"theme": "One Dark.sublime-theme"
}
路径大小写、斜杠方向、文件扩展名（.tmTheme 不是 .sublime-color-scheme）全要对，错一个就只生效一半。
为什么改了设置还是不黑？检查这三处硬性依赖
One Dark 主题依赖 Sublime Text 3.3+（2020 年后版本），老版本会报错或渲染异常；另外它默认禁用某些 UI 元素的自定义样式，导致侧边栏字体发虚、图标模糊等“半生效”现象。
-
"one_dark_sublime_text_2": true这行只对 Sublime Text 2 有效，ST3/4 加了反而报错，删掉 - 如果用了
Adaptive或Material Theme等其他 UI 主题，它们会覆盖"theme"设置，得先卸载或禁用 - 某些插件（如
Origami、SideBarEnhancements）会强行重绘侧边栏，需在插件设置里关掉"draw_sidebar_arrows"或设为false
配色方案不匹配？别混用 VSCode 的 One Dark Pro 资源
Sublime 的 One Dark.tmTheme 是基于原生 XML 格式写的，而 VSCode 的 One Dark Pro 是 JSON + CSS 变量体系，两者文件结构、颜色定义方式、作用域命名全不同。直接把 VSCode 的 colors.json 或 themes/OneDarkPro-color-theme.json 放进 Sublime 的 Packages/User 目录，不仅不会生效，还可能让 Color Scheme 列表里出现乱码条目。
- 想微调颜色？编辑
Packages/Theme - One Dark/One Dark.tmTheme文件，改<key>foreground</key>对应的<string>#abb2bf</string>值即可 - 改完保存后不用重启，但要确保当前文件类型有对应作用域（比如
.py文件得有source.pythonscope 才能触发高亮规则） - 临时验证是否加载成功：打开命令面板
Ctrl+Shift+P→ 输入Color Scheme，看列表里是否显示Theme - One Dark/One Dark，而不是一堆灰色不可选项
侧边栏文字太细、图标缺失？这是字体渲染和图标主题缺位
One Dark 主题默认用系统等宽字体渲染侧边栏，Chromebook 或 Linux 下常因缺少 Fira Code 或 Source Code Pro 导致文字发虚；图标则完全依赖第三方图标主题（如 FileIcons），Sublime 自身不提供文件类型图标。
- 在用户设置里加一行：
"font_face": "Fira Code"（需先在系统安装该字体，否则 fallback 到默认字体） - 图标必须另装插件：用 Package Control 安装
FileIcons，然后在Settings - User里加"file_icons": true - 如果用了
Material Theme替代方案，它的图标集成更完整，但会和One Dark.sublime-theme冲突，二者不能共存
最常被忽略的是：Sublime 的 Theme - One Dark 项目已多年未更新，最新适配只到 ST4143，如果你用的是 ST4160+，部分 UI 元素（如新标签页关闭按钮）可能位置偏移——这时不是你配错了，是主题本身还没跟进新版 API。
