ayu-light主题未生效需检查三处：theme必须为"ayu-light.sublime-theme"，color_scheme须用大小写敏感完整路径如"packages/ayu/schemes/ayu-light.sublime-color-scheme"，且配置必须放在用户设置中。
装完 ayu-light 主题后界面没变？不是安装失败，而是 "theme" 和 "color_scheme" 两项配置写错位置或格式不对——Sublime 不报错，直接静默回退到默认主题。
确认 ayu-light 已正确安装
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Package Control: List Packages 回车，检查列表中是否出现 ayu（不是 ayu-light 单独一项，整个主题包就叫 ayu）。如果没看到，说明没装成功，重试 Install Package → 搜 ayu → 回车。
手动安装路径需校验：进入 Preferences > Browse Packages…，确认目录下存在名为 ayu 的文件夹，且内部有 schemes/ 子目录和 ayu-light.tmTheme（或 ayu-light.sublime-color-scheme）文件。
用户设置里必须写对 theme 和 color_scheme 值
这两项必须写在 Preferences > Settings – User（不是 Default），且 JSON 格式合法、无注释块干扰。
-
"theme"必须带完整后缀："ayu-light.sublime-theme"（不能只写"ayu-light"） -
"color_scheme"必须是大小写敏感的完整路径："Packages/ayu/schemes/ayu-light.tmTheme"或"Packages/ayu/schemes/ayu-light.sublime-color-scheme"（2025 年后新装 Sublime 默认用后者，老版包仍发.tmTheme；若路径错或文件不存在，主题不生效也不提示） - 别漏掉逗号，别把配置写在注释块
/* ... */或//后面——Sublime 的 JSON 解析器不认这些
正确示例：
{
"theme": "ayu-light.sublime-theme",
"color_scheme": "Packages/ayu/schemes/ayu-light.sublime-color-scheme"
}
侧边栏图标、滚动条等 UI 细节要单独开
ayu-light 本身不带文件图标，想让侧边栏显示文件类型图标，必须额外装 A File Icon 插件，并启用它：右键点击侧边栏空白处 → 勾选 Enable File Icons。
其他常用 UI 调整不用改主题文件，直接加进用户设置即可：
- 宽滚动条：
"ui_wide_scrollbars": true - 隐藏所有分隔线（标签页底边、侧边栏内边距等）：
"ui_separator": false - 调浅侧边栏背景色（护眼增强）：需手动编辑
ayu-light.sublime-theme文件里的sidebar_container→layer0.tint，改成如"#E8F5E8"这类柔绿值
为什么 light 模式还是刺眼？检查这三点
ayu-light 默认背景是纯白 #FFFFFF，白天靠窗工位易反光、显脏。真护眼得动两处：
- 改配色方案的
background：用PackageResourceViewer: Open Resource打开ayu-light.tmTheme，搜<key>background</key>，把紧随其后的<string>#FFFFFF</string>改成#DCF1E5或#E8F5E8 - 同步改侧边栏颜色：同上文件里找
sidebar_container→layer0.tint，设为相同柔色值 - 禁用高亮当前行：
"highlight_line": false（加进用户设置），避免白底+黄底叠加造成视觉跳变
最常被忽略的是 .tmTheme 和 .sublime-color-scheme 格式混用——新版 Sublime 优先读后者，但部分 ayu 包仍未更新该文件，此时即使路径写对也加载失败。
