CityLights 主题需手动安装且配置路径严格：未上架 Package Control，须从 GitHub 下载 ZIP 解压后移至 Packages 目录，再在 Settings–User 中正确设置 theme 和 color_scheme 路径，否则界面无变化。
CityLights 主题不是 Package Control 官方仓库默认收录的主题，直接搜 “CityLights” 通常找不到——它需要手动安装，且配置路径容易写错，导致界面毫无变化。
确认 CityLights 是否已上架 Package Control
打开命令面板 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 并回车。在搜索框里键入 CityLights，等列表加载完毕后观察：
- 如果没出现任何结果，说明它未被提交到官方仓库，不能一键安装
- 如果出现 CityLights Theme 或类似条目，可点击安装，但注意后续仍需核对路径是否匹配
- 实测截至 2026 年 7 月，主流 Package Control 镜像（包括 packagecontrol.io）中无该主题索引
手动安装 CityLights 主题文件
必须从作者源获取原始文件，否则会因结构缺失导致 UI 崩溃（比如侧边栏消失、标签页变白）。操作步骤如下：
- 访问 CityLights 主题 GitHub 仓库（通常为 https://github.com/ahmadassaf/CityLights，请以 README 中最新链接为准）
- 点击 Code → Download ZIP，解压后得到一个含 CityLights.sublime-theme 和 schemes/ 文件夹的目录
- 将整个解压后的文件夹重命名为 CityLights（不含空格、不加版本号）
- 移动到 Sublime Text 的 Packages 目录：
- Windows：
C:\Users\{用户名}\AppData\Roaming\Sublime Text 3\Packages\ - macOS：
~/Library/Application Support/Sublime Text 3/Packages/ - Linux：
~/.config/sublime-text-3/Packages/
Installed Packages，那里只放 .sublime-package 归档包正确配置 theme 和 color_scheme 路径
很多人卡在这步：改了设置却没生效，原因是路径拼写错误或大小写不一致（macOS/Linux 区分大小写，Windows 虽不区分但建议统一）。在 Preferences → Settings – User 右侧添加：
{
"theme": "CityLights.sublime-theme",
"color_scheme": "Packages/CityLights/schemes/CityLights.tmTheme"
}
- "theme" 值必须是 .sublime-theme 文件名，不是文件夹名
- "color_scheme" 必须指向 .tmTheme 文件的完整相对路径，Packages/ 是根前缀，后面跟的是你放进去的文件夹名 + 子路径
- 若作者把配色方案放在 schemes/CityLights-Dark.tmTheme，那就得写全名，不能省略 -Dark
- 修改后保存，无需重启，但需确保当前文件没有被设为“Plain Text”语法（右下角显示不是 Plain Text）
常见失效原因与验证方式
如果配置完仍显示默认浅色界面：
- 检查控制台是否有报错：Ctrl+` 打开，看是否提示 Unable to open … CityLights.sublime-theme
- 进入 Preferences → Theme，下拉菜单里是否出现了 CityLights 条目？没出现 = 文件没放对位置或文件名不对
- 打开 Preferences → Color Scheme，能否找到 CityLights 开头的选项？找不到 = schemes/ 下的文件没放对或扩展名不是 .tmTheme
- 某些 CityLights 分支使用 .sublime-color-scheme（JSON 格式），这种不能用在旧版 Sublime Text 3 上，必须用 ST4（build 4122+）才支持
