Agila Theme安装失败主因是Package Control未安装或网络被墙；正确安装后需刷新包索引、准确输入“Agila Theme”并配置color_scheme和theme，启用Neon子主题还需开启file_icons等选项。
Agila Theme安装失败：Package Control没装或网络卡住
多数人卡在第一步，不是主题本身问题，而是Package Control根本没装上，或者装了但被墙拦住。命令面板里搜不到Install Package，说明Package Control压根没生效。
别反复粘贴网上五花八门的安装脚本——2026年最新稳定安装方式只有一条：
- 按
Ctrl+`（Windows/Linux）或Cmd+`（macOS）打开控制台 - 粘贴并回车运行官方最新安装行：
import urllib.request,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib.request.urlopen('https://packagecontrol.io/'+pf.replace(' ','%20')).read()) - 看到
Package Control installed才算成功，必须重启 Sublime Text
如果报错 URLError 或卡在 loading packages...，不是代码错，是本地网络无法直连 packagecontrol.io —— 此时手动安装更可靠：去 https://packagecontrol.io/installation 下载 Package Control.sublime-package 文件，放进 Packages/ 目录后重启。
用命令面板装Agila Theme却搜不到名字
输入 Package Control: Install Package 后列表空白，或搜 Agila 没结果，常见原因就两个：插件列表缓存未更新、或名称拼写不对。
Agila Theme 在 Package Control 中注册的准确包名是 Agila Theme（带空格，首字母大写），不是 agila、Agila-Theme 或 AgilaTheme。
- 先确保已重启 Sublime，再按
Ctrl+Shift+P→ 输入Package Control: Upgrade Package→ 等它跑完（约10秒），这是刷新远程包索引的唯一方式 - 刷新后再输
Package Control: Install Package，输入Agila Theme，注意空格和大小写 - 若仍无结果，直接去 GitHub 页面
https://github.com/arvi/Agila-Theme下载main.zip，解压后重命名为Agila Theme文件夹，扔进Packages/目录即可
主题启用后侧边栏变了但编辑区还是白底黑字
这是最典型的配置错位：你改了 theme，但没配 color_scheme。Agila Theme 自带多套配色方案（如 Agila Light.tmTheme、Agila Dark.tmTheme），它们和 UI 主题是解耦的，必须单独指定。
- 按
Ctrl+Shift+P输入Color Scheme，在弹出列表中找带Agila前缀的项，比如Agila Light或Agila Dark，选中即生效 - 右下角状态栏会立刻显示完整路径，例如
Packages/Agila Theme/schemes/Agila Dark.tmTheme—— 这个路径就是你要复制进用户设置里的值 - 手动写配置时，
"color_scheme"字段必须以Packages/开头，且大小写、斜杠、空格、扩展名（.tmTheme）一个都不能错；"theme"字段则只写文件名，如"Agila Theme.sublime-theme"
选了Agila Neon子主题但标签页圆角/图标不显示
Agila Theme 的子主题（如 Agila Neon.sublime-theme）依赖额外开关，光换 theme 文件不够。它需要显式启用图标支持和 UI 渲染增强项，否则只呈现基础布局。
打开 Preferences → Settings，在右侧用户设置中补全以下字段：
{
"theme": "Agila Neon.sublime-theme",
"color_scheme": "Packages/Agila Theme/schemes/Agila Dark.tmTheme",
"file_icons": true,
"material_theme_small_tab": true,
"bold_folder_labels": true
}
其中 "file_icons": true 是关键，Agila Neon 的彩色文件图标和圆角标签页都靠它驱动；"material_theme_small_tab" 虽然名字带 Material，但 Agila 内部复用了这部分渲染逻辑，不加这行圆角会退化成直角。
改完保存，必须完全退出 Sublime Text（不只是关窗口），再重新打开——UI 缓存不清理，旧样式会残留。
