base16主题在sublime text中需通过package control分别安装兼容ui主题（如spacegray）和base16配色方案（如base16-ocean.dark.tmtheme），再手动在用户设置中精确配对theme与color_scheme路径，重启后生效。
Base16 系列主题在 Sublime Text 中不能直接“一键安装”，必须通过 Package Control 安装配套的 UI 主题（如 Spacegray）和 Base16 配色方案（如 base16-ocean.dark.tmTheme），再手动配对生效——缺一不可，否则编辑区或 UI 会显示为默认黑底白字或错位灰块。
确认你装的是 Base16 兼容的 UI 主题
Base16 本身只是颜色规范，不是完整主题。Sublime 中真正起作用的是实现了 Base16 的 UI 主题，比如 Spacegray、Ayu 或 One Dark（部分变体）。其中 Spacegray 是最成熟、变体最全的选择，它原生支持所有 Base16 颜色方案切换。
- 用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Install Package→ 回车 → 搜索并安装Spacegray - 安装后别急着改设置，先验证是否成功：打开
Preferences → Theme，列表中应出现多个Spacegray *选项（如Spacegray.sublime-theme） - 如果只看到
Default或空白，说明安装失败或被插件冲突拦截，可检查Packages/Spacegray/目录是否存在
安装 Base16 配色方案（.tmTheme 文件）
Base16 配色方案是独立于 UI 主题的，需单独安装。官方推荐方式是通过 Package Control 安装 Base16 Color Schemes 插件，它会把全部 32+ 种 Base16 方案（含 light/dark 变体）一次性放进 Packages/Base16 Color Schemes/ 目录。
- 命令面板输入
Install Package→ 搜索Base16 Color Schemes→ 安装 - 安装完成后，路径
Packages/Base16 Color Schemes/base16-ocean.dark.tmTheme就真实存在了 - 不要手动下载 .tmTheme 文件再拖进
User目录——容易路径写错、大小写不匹配，且无法自动更新 - 验证是否可用：打开
Preferences → Color Scheme，展开Base16 Color Schemes子菜单，能看到所有方案名（如base16-ocean.dark）
手动配对 theme 和 color_scheme（关键一步）
即使两个包都装好了，Sublime 默认也不会自动关联它们。必须在用户设置里显式指定路径，而且路径必须完全准确——错一个字母、漏一个斜杠、大小写不对，都会静默失效。
- 打开
Preferences → Settings – User - 写入以下内容（以
Spacegray+base16-ocean.dark为例）：
{
"theme": "Spacegray.sublime-theme",
"color_scheme": "Packages/Base16 Color Schemes/base16-ocean.dark.tmTheme",
"font_size": 12
}
-
"theme"值必须和Preferences → Theme列表中显示的文件名完全一致（注意后缀是.sublime-theme） -
"color_scheme"路径中的Packages/开头不能省略，Base16 Color Schemes名称要和插件安装后的文件夹名完全一致（空格、连字符都不能错） - 改完保存，界面不会立即刷新——关掉所有窗口再重开 Sublime，或重启软件才生效
换 Base16 变体时只改 color_scheme，别动 theme
Base16 的核心价值是“一套 UI 主题 + 多套配色自由切换”。比如你已配好 Spacegray，想从 ocean 换成 eighties，只需改 color_scheme 行，theme 保持不变。
- 例如换成八零年代风：
"color_scheme": "Packages/Base16 Color Schemes/base16-eighties.dark.tmTheme"
- 换成浅色版（注意文件名含
.light）：
"color_scheme": "Packages/Base16 Color Schemes/base16-ocean.light.tmTheme"
- 切记：每次换配色都要确认右下角状态栏显示的方案名是否更新；如果没变，大概率是路径拼写错误，而不是主题不兼容
- 某些 Base16 方案（如
monokai）虽在列表里，但和Spacegray的 UI 色调不协调，视觉会割裂——这不是 bug，是 Base16 规范允许的自由组合，效果靠试
最容易被忽略的是路径大小写和空格：Windows 下不敏感，macOS 和 Linux 下 Base16 Color Schemes 写成 base16 color schemes 就彻底找不到；复制粘贴时 Ctrl+V 进控制台的路径若带零宽空格，JSON 解析失败也不会报错，只会回退到默认样式。
