主题文件夹必须放在packages目录下，不能放错位置；sublime只扫描packages及其子目录（如packages/mytheme/）中的.sublime-theme文件，放错路径则完全无视且不报错，正确路径需通过preferences → browse packages打开，启用前须重启并手动配置"theme"键指定完整文件名。
主题文件夹必须放在Packages目录下，不能放错位置
手动安装的主题不会自动注册，Sublime 只扫描 Packages 目录及其子目录（如 Packages/MyTheme/）里的 .sublime-theme 文件。如果把解压后的文件夹拖进 Packages/User/ 或直接丢到 Data/ 根目录，Sublime 完全无视——不报错、不提示、界面毫无变化。
正确路径示例：
- Windows：
C:\Users\用户名\AppData\Roaming\Sublime Text 3\Packages\ - macOS：
~/Library/Application Support/Sublime Text 3/Packages/ - Linux：
~/.config/sublime-text-3/Packages/
操作建议：
- 用
Preferences → Browse Packages打开目录，这是最稳妥的路径入口 - 解压后重命名文件夹为简洁英文名（如
Ayu、Material Theme），避免空格或中文 - 确认文件夹内含
xxx.sublime-theme（UI 主题）和/或xxx.tmTheme（配色方案），缺一不可
启用前必须重启，且需通过命令面板或设置文件激活
复制完文件夹只是“部署”，不是“启用”。Sublime 不会在启动时自动加载新主题，必须显式触发。
两种可靠方式：
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入UI: Select Theme，从列表中选目标主题（带 ✔️ 表示已启用） - 手动编辑
Preferences → Settings – User，添加字段："theme": "Ayu.sublime-theme"（注意大小写与扩展名）
常见失效现象：
- 列表里没出现主题名 → 文件夹名或路径错，或主题文件不叫
.sublime-theme - 点了主题但 UI 没变 → 没重启，或配置写在了
Settings – Default（会被覆盖） - 侧边栏颜色不变但标签页变了 → 主题本身不支持深色侧边栏（如 Adaptive），得换完整 UI 主题（如
Material-Theme-Darker.sublime-theme）
color_scheme 和 theme 是两套系统，不能混用路径
很多人以为改了 theme 就能控制代码区背景，结果发现编辑区还是黑底白字——因为那是 color_scheme 管的，和 UI 主题完全无关。
手动配置时必须分别指定：
-
"theme": "Ayu.sublime-theme"→ 控制侧边栏、标签页、状态栏等 -
"color_scheme": "Packages/Ayu/ayu-mirage.tmTheme"→ 控制代码区语法高亮与背景色
关键细节：
-
color_scheme路径必须以Packages/开头，不能写成packages/（小写）、./或省略 - 如果配色文件在
Packages/User/下，路径应为Packages/User/my-scheme.tmTheme - 复制路径时容易粘贴进零宽空格，JSON 解析失败却不报错；建议手敲引号和斜杠
图标不显示？大概率是 icon_theme 没配或文件类型未映射
装了 UI 主题和 A File Icon 后图标仍为空白，不是主题问题，而是 Sublime 默认只识别常见后缀（如 .js、.py）。.env、.yml、.tsx 这类需手动声明。
解决步骤：
- 确认已安装图标插件：用
Ctrl+Shift+P输入Package Control: Install Package→ 搜A File Icon - 编辑
Preferences → Package Settings → A File Icon → Settings - 在用户设置中加
file_extensions规则，例如："file_extensions": ["env", "yml", "yaml"]
其他高频原因：
-
"icon_theme": "A File Icon"写成"a file icon"（大小写敏感） - 只配了
theme没配icon_theme→ 图标不渲染，但 UI 正常 - 改完设置没重启 Sublime → 图标始终空白
路径和大小写错一个字符，Sublime 就静默跳过，既不加载也不报错——这是最容易被忽略的复杂点。
