sublime text 主题和配色方案必须严格按路径、扩展名、大小写手动放置，且需在 settings - user 中精确配置 json 路径；装错位置或格式错误均静默失效，不报错；st3/st4 版本兼容性差异亦需注意。
主题和配色方案必须分开手动放对位置
Sublime Text 不会自动扫描任意文件夹里的主题或配色文件，theme 和 color_scheme 必须分别放进特定目录，且扩展名、大小写、路径结构全要对。装错位置=完全不生效，而且不会报错。
-
.sublime-theme文件（UI 主题）必须放在Packages/User/或对应插件子目录下，例如Packages/Theme - One Dark/One Dark.sublime-theme -
.tmTheme文件（配色方案）同理，推荐放Packages/User/或Packages/Theme - One Dark/One Dark.tmTheme，不能是.sublime-color-scheme（那是 ST4 新格式，旧主题不兼容） - 路径中
Packages/是固定前缀，不是你电脑上的磁盘路径；用Preferences → Browse Packages打开的才是真实目录 - 文件名含空格或短横（如
One Dark.sublime-theme）必须一字不差，Windows 下不区分大小写但 Sublime 内部解析严格按大小写匹配
配置文件里写错一个字符就白装
手动安装后，必须进 Preferences → Settings - User 显式指定路径，JSON 格式容错极低——引号用中文、逗号漏写、斜杠反了、多空格，都会让整个配置静默失效，界面退回默认浅灰。
- 正确示例：
"theme": "One Dark.sublime-theme"，不是"theme": "OneDark.sublime-theme"（少空格） -
"color_scheme": "Packages/Theme - One Dark/One Dark.tmTheme"，注意Packages/开头、中间空格、.tmTheme后缀 - 别把
color_scheme路径写成本地绝对路径（如C:/.../One Dark.tmTheme），Sublime 只认Packages/开头的相对路径 - 改完保存，立刻按
Ctrl+Shift+P输入Reload Window重载窗口，不重启也能生效
侧边栏/图标/字体糊？不是主题没装好，是缺配套设置
One Dark、Spacegray 这类深色 UI 主题默认不管侧边栏字体大小、折叠箭头、文件图标——你看到“半黑”“发虚”“图标小”，大概率是主题已加载成功，但底层渲染参数没调。
- 加这行强制统一字体大小：
"font_size": 12（太小看不清，太大占空间） - 关掉侧边栏动画避免抖动：
"tree_animation_enabled": false - 显示文件图标需额外装插件：Package Control 搜
FileIcons，装完再加"file_icons": true - 某些主题（如 Adaptive）会覆盖
theme设置，确认没同时启用多个 UI 主题
ST3 和 ST4 对同一主题的兼容性差异
Sublime Text 4 默认启用新渲染引擎，部分老主题（尤其 ST2 时代写的）会颜色错位、按钮消失或状态栏断层。不是你操作错了，是版本硬限制。
- 别在 ST4 的用户配置里留
"one_dark_sublime_text_2": true，这行只对 ST2 生效，ST4 加了反而干扰加载 - Theme - One Dark 要求 ST3.3+，低于这个版本会报
invalid theme format错误，直接不加载 - 如果用的是 GitHub 上下载的独立
.sublime-theme文件，优先查 README 是否标注支持 ST4；没标的基本默认只适配 ST3 - ST4 用户更推荐用 Package Control 安装的最新版主题，更新日志里会明确写 “ST4 compatible”
实际生效最难卡住的点，往往不在安装步骤，而在路径大小写、JSON 格式细节、以及 ST 版本与主题元数据的隐式匹配——这些地方错一点，界面就“看起来像装了，其实只跑了一半”。
