AgilaTheme必须同时配置theme和color_scheme才能生效；仅安装不配置则退回默认UI。通过Package Control安装后，需在Settings-User中正确填写两项路径，且color_scheme必须以Packages/开头、区分大小写，重启后验证是否启用。
AgilaTheme 能直接用，但必须同时配对 theme 和 color_scheme，缺一不可；单独装好不配置，界面不会变，也不会报错——它就默默退回默认白灰 UI。
用 Package Control 一键安装 AgilaTheme
这是最稳的方式，能自动处理依赖和路径结构：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成，输入
Agila Theme（注意空格，大小写不敏感） - 选中后回车安装，成功后状态栏会提示 “Agila Theme installed”
安装完别急着改设置——先看下一步怎么启用，否则容易白装。
启用 AgilaTheme 必须配齐两个配置项
AgilaTheme 包含 UI 主题（.sublime-theme）和语法高亮（.tmTheme）两部分，只设一个，编辑区或侧边栏必有一块“掉皮”。正确路径必须从命令面板里抄：
- 按
Ctrl+Shift+P输入UI: Select Theme，带 ✔️ 的项就是当前生效的theme值，例如：Agila-Theme.sublime-theme - 再按
Ctrl+Shift+P输入Color Scheme，点开任意 Agila 变体（如Agila Light），状态栏右下角显示的完整路径就是color_scheme值，例如：Packages/Agila Theme/schemes/Agila-Light.tmTheme - 打开
Preferences → Settings - User，粘贴进 JSON，确保格式合法：
{
"theme": "Agila-Theme.sublime-theme",
"color_scheme": "Packages/Agila Theme/schemes/Agila-Light.tmTheme"
}
⚠️ 注意：color_scheme 必须以 Packages/ 开头，不能漏、不能写成 packages/（小写在 macOS/Linux 下不认），也不能省略空格和短横。
手动安装时路径和命名要严格对齐
如果从 GitHub 下载 ZIP 或用 git clone，容易栽在文件夹名和路径上：
- 解压后文件夹名必须是
Agila Theme（含空格，不是agila-theme或AgilaTheme） - 整个文件夹必须放进
Packages/目录，路径示例：~/.config/sublime-text-3/Packages/Agila Theme/ - 检查子目录结构：主题文件应在
Agila Theme/Agila-Theme.sublime-theme，配色方案应在Agila Theme/schemes/Agila-Light.tmTheme - 重启 Sublime Text 才会扫描新包；若仍不生效，先删掉
Cache/目录（路径同Packages/）再试
常见失效原因和快速验证法
主题“装了但没反应”，90% 是路径或缓存问题：
- 改完设置没重启 Sublime —— 缓存不刷新，UI 不更新
- 复制路径时带了零宽字符（尤其从网页粘贴），建议手敲或从命令面板里右键复制
- 用了
.sublime-color-scheme后缀（Sublime Text 4 新格式），但 AgilaTheme 目前只提供.tmTheme - 多个主题插件冲突（比如同时装了 Material Theme 和 Agila），禁用其他主题插件再试
最省事的验证方式：打开命令面板，分别执行 UI: Select Theme 和 Color Scheme，看 Agila 相关项是否出现在列表里且带 ✔️——没出现，说明没装对；出现了但没生效，大概率是用户设置里路径写错了。
