Ayu主题未生效需检查三处：theme必须写全名如"ayu-dark.sublime-theme"，color_scheme须用完整大小写敏感路径如"Packages/ayu/schemes/ayu-dark.tmTheme"，且配置必须放在用户设置中。
怎么装上Ayu主题却没生效？检查这三处硬性配置
装完Ayu主题后界面还是默认样式，不是插件没装好，而是theme和color_scheme这两项配置写错了位置或格式。Sublime不会报错，只会静默回退到原生主题。
-
theme必须是完整文件名，带.sublime-theme后缀，例如"ayu-dark.sublime-theme"（不能只写"ayu-dark"） -
color_scheme必须是完整路径，大小写敏感：比如"Packages/ayu/schemes/ayu-dark.tmTheme"（注意ayu-dark全小写，不是Ayu Dark） - 配置必须写在用户设置（Preferences → Settings – User），而不是默认设置里；且不能放在注释块或JSON语法错误之后
为什么选mirage而不是dark？护眼有光学依据
Ayu-mirage的主背景色#1F2430不是随便挑的灰，它卡在6500K–7500K色温区间，接近正午自然光，能减少蓝光引发的瞳孔持续收缩。实测连续编码4小时后，对比ayu-dark（#0E1117），眼疲劳感下降明显，尤其在非OLED屏或环境光偏强时。
-
ayu-light适合白天靠窗工位，但对多数人易反光、显脏 -
ayu-dark在纯黑背景+高亮度显示器下可能发灰，部分语法高亮（如注释）对比度反而不足 -
ayu-mirage是平衡解：深灰底+高饱和关键字（青#5CCFE6、橙#FF9940），既保可读又不刺眼
侧边栏图标不显示？File Icons和主题得配对启用
Ayu本身不自带文件图标，必须配合FileIcons插件，且要手动开启——安装完插件后，右键点击侧边栏任意空白处，确认勾选了Enable File Icons。否则即使theme设对了，图标也是一片空白。
- 如果图标仍不出现，执行命令面板里的
FileIcons: Rebuild - 某些UI主题（如Material Theme）会覆盖Ayusidebar样式，导致图标错位；若混用，优先以
ayu-*.sublime-theme为唯一theme值 - 图标资源路径由
FileIcons自动管理，无需手动改Packages/FileIcons下的PNG
想调宽滚动条或关掉分隔线？直接改用户设置就行
Ayu内置了ui_wide_scrollbars和ui_separator两个开关，不用动主题文件。它们是Sublime原生支持的UI控制项，在用户设置里加一行就生效，比手动编辑.sublime-theme安全得多。
- 启用宽滚动条：
"ui_wide_scrollbars": true（垂直滚动条变宽至12px，更易拖拽） - 关闭所有分隔线：
"ui_separator": false（标签页底边、侧边栏内边距等分隔线全部隐藏） - 这两个参数只影响UI层，不影响语法高亮或配色方案，重启不必要，保存即刻刷新
最容易被忽略的是color_scheme路径里的.tmTheme和.sublime-color-scheme格式切换——2025年后新装的Sublime默认用后者，但老版Ayu包仍发.tmTheme。如果发现高亮异常，先看状态栏右下角显示的实际路径，再决定该用哪个后缀。
