安装Ayu主题必须用Package Control，手动复制易出错；Package Control能自动适配.sublime-color-scheme格式并校验依赖，安装后需在Preferences → Color Scheme中手动启用ayu-dark/light/mirage，且须配合FileIcons插件并开启其开关才能显示侧边栏图标，路径大小写、后缀及完整Packages/前缀缺一不可。
安装Ayu主题必须用Package Control，手动复制容易出错
直接克隆仓库或解压到Packages目录看似省事，但2026年新版Sublime默认使用.sublime-color-scheme格式，而老版Ayu包仍发.tmTheme——混用会导致颜色方案不加载、语法高亮失效。Package Control能自动适配格式并校验依赖。
操作要点：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）调出命令面板 - 输入
Package Control: Install Package并回车 - 等待几秒等列表加载完成（别急着输
ayu，否则搜不到） - 输入
ayu，选中ayu（不是ayu-theme或ayu-color-scheme）安装
装完不用重启，但需手动启用：菜单Preferences > Color Scheme > ayu > ayu-dark（或ayu-light/ayu-mirage）。
侧边栏图标不显示？只装Ayu主题远远不够
Ayu本身不带图标资源，ayu-*.sublime-theme文件里根本没有图标定义逻辑。图标由FileIcons插件注入，但必须满足两个硬条件：当前UI主题支持图标渲染 + 插件开关已开启。
常见错误现象：
- 装了
ayu和FileIcons，侧边栏仍是空白方块 - 右键侧边栏没出现
Enable File Icons选项 - 用户设置里加了
"icons": true但无效
正确做法：
- 先确认已安装
FileIcons（不是AFileIcon，后者是旧名，新包名就是FileIcons） - 菜单
Preferences > Package Settings > FileIcons > Settings，确保配置里有"enabled": true - 右键侧边栏空白处，勾选
Enable File Icons（这步必须做，设置项不自动触发） - 检查用户设置中
"theme"值是否为"ayu-dark.sublime-theme"等合法值（拼写错一个字符就回退到Default主题）
theme和color_scheme路径必须严格匹配，大小写敏感
Sublime对路径大小写极其敏感，尤其Linux/macOS系统下Packages/ayu/schemes/ayu-dark.tmTheme写成AYU或ayu-dark.TMTHEME都会静默失败——界面无报错，但配色变灰白、图标消失。
推荐直接从主题包内读取路径：
- 菜单
Preferences > Browse Packages，打开ayu文件夹 - 进
schemes/子目录，看实际文件名是ayu-dark.tmTheme还是ayu-dark.sublime-color-scheme - 在用户设置中填完整路径：
"color_scheme": "Packages/ayu/schemes/ayu-dark.sublime-color-scheme" -
theme同理，必须是"ayu-dark.sublime-theme"，不能漏掉.sublime-theme后缀
注意：2025年后新装Sublime默认启用.sublime-color-scheme，若你用的是老版Ayu包，得手动把.tmTheme转成新格式，或换用GitHub上已更新的fork版本。
想调滚动条宽度或关分隔线？别碰.sublime-theme文件
很多人去编辑ayu-dark.sublime-theme想改UI细节，结果主题崩溃或升级后覆盖丢失。Sublime原生支持ui_wide_scrollbars和ui_separator两个安全开关，改用户设置就行。
实操建议：
- 宽滚动条：
"ui_wide_scrollbars": true（垂直滚动条变12px，拖拽更准） - 隐藏所有分隔线：
"ui_separator": false（标签页底边、侧边栏内边距等全消失） - 这两个参数保存即生效，无需重启，且不随主题更新被覆盖
- 别在
.sublime-theme里硬编码scroll_bar尺寸——那会破坏主题响应式逻辑
真正容易被忽略的是：FileIcons插件启用后，图标缓存可能卡住。如果换主题后图标不更新，执行FileIcons: Rebuild Icon Cache命令（命令面板搜这个）比重启更有效。
