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设对了，图标也是一片空白。

材料星

一款AI工具，主要用于专为面向体制内、企事业单位文秘及职场文字工作者的垂直AI写作工具，适合需要提升相关任务效率的用户。

下载

• 如果图标仍不出现，执行命令面板里的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。如果发现高亮异常，先看状态栏右下角显示的实际路径，再决定该用哪个后缀。