Aura Theme 无法通过 Package Control 安装,因其未提交至官方仓库;必须手动 git clone 至 Packages/Aura 目录,并在用户设置中严格配置 theme 和 color_scheme 路径,大小写与斜杠方向均需正确,且重启后生效。

Sublime Text 安装 Aura Theme 并不能直接通过 Package Control 找到——它不在官方插件仓库中,强行搜索会返回空结果或误装同名但无关的插件。必须手动安装,且路径、文件名、大小写三者任一出错,主题就静默失效。
为什么 Package Control 里搜不到 Aura Theme
Aura Theme 是一个未提交至 Package Control 官方仓库的第三方 UI 主题,GitHub 主页(https://github.com/braver/aura)明确说明:不支持通过 Package Control 安装。所有声称“Package Control 可装 Aura”的教程,实际指向的是另一个已下架/重命名的旧项目,或混淆了 Ayu、Aurora 等相似名称主题。
- 当前(2026年7月)最新稳定版是
v2.1.0,发布于 2025 年 12 月 - 官方只提供 GitHub Release 下载和 git clone 两种方式
- 尝试在命令面板输入
Install Package→ 搜索Aura,结果为空或仅显示Aura Color Scheme(配色方案,非 UI 主题)——这是常见误判点
手动安装 Aura Theme 的三步实操
跳过 Package Control,直取源码,确保版本可控、路径可验:
- 打开终端,执行:
git clone https://github.com/braver/aura.git ~/Library/Application Support/Sublime Text 3/Packages/Aura(macOS);Windows 用户对应路径为:%APPDATA%\Sublime Text 3\Packages\Aura - 不要解压 zip 后重命名文件夹——git clone 生成的目录结构已符合 Sublime 要求,包含必需的
Aura.sublime-theme和schemes/子目录 - 确认
Aura文件夹内有且仅有这些关键文件:Aura.sublime-theme、auradark.tmTheme、auralight.tmTheme;缺任何一个,后续无法启用
启用时必须同时配置 theme 和 color_scheme
Aura 是 UI 主题(控制侧边栏、标签页、状态栏样式),但它不自带配色方案。必须手动指定配套的 .tmTheme 文件,否则编辑区仍为默认白底黑字,UI 变化仅限界面框架:
- 按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Win/Linux),输入Preferences: Settings – User打开用户配置 - 写入以下内容(注意大小写与斜杠方向):
{ "theme": "Aura.sublime-theme", "color_scheme": "Packages/Aura/schemes/auradark.tmTheme", "font_size": 13, "tab_size": 2 } -
"color_scheme"路径必须以Packages/开头,且Aura首字母大写——小写aura在 macOS 上会失败;Windows 不区分大小写但建议统一 - 改完保存,**必须完全退出 Sublime Text 再重启**,仅
Ctrl+Shift+P → Reload Settings不生效
常见失效原因和验证方式
主题“看起来没变”,90% 是路径或缓存问题,不是安装失败:
- 状态栏右下角不显示
auradark.tmTheme?说明color_scheme路径错——用命令面板Color Scheme菜单点开,复制带 ✔️ 的那一行完整路径,粘贴进配置 - 侧边栏变紫但标签页仍是灰色?说明
theme生效但color_scheme未加载——检查schemes/目录是否存在,文件名是否为auradark.tmTheme(不是Aura-Dark.tmTheme或aura-dark.tmTheme) - 重启后仍为默认界面?删除用户设置里其他主题相关字段(如
"material_theme"、"ayu"等残留配置),避免冲突 - 终端执行
subl --debug启动,观察控制台输出是否有Unable to open ... Aura.sublime-theme报错,这是最直接的路径验证方式
真正卡住人的不是下载动作,而是 Sublime 对路径字符串的零容忍——多一个空格、少一个斜杠、大小写偏差,它都不报错,只默默回退到原始界面。动手前先用命令面板确认当前生效项,比反复重装高效得多。


















