sublime text 4升级后旧主题异常的根本原因是弃用.tmtheme格式且渲染逻辑变更；需通过inspect color scheme确认加载状态，用tmtheme editor转换为合法.sublime-color-scheme，并修正scope匹配与字体渲染设置。
Sublime Text 升级到 4（Build 4166+）后，旧主题包显示异常——比如语法高亮全灰、括号不着色、中文渲染发虚、侧边栏图标错位——根本原因不是“主题坏了”，而是 ST4 彻底弃用了 .tmTheme 格式，且 UI 渲染逻辑和 scope 匹配规则变了。直接换新主题能绕过问题，但若想复用旧主题，得动手改。
确认主题是否被 ST4 加载失败
别信右下角显示的“Monokai”或“Adaptive”——它可能只是 fallback。打开命令面板 Ctrl+Shift+P，输入 Inspect Color Scheme：
• 如果输出 No color scheme loaded 或路径指向 Packages/Color Scheme - Default/Monokai.sublime-color-scheme，说明你设的 theme 根本没加载
• 如果路径是 Packages/User/MyOldTheme.tmTheme，那基本可以确定：ST4 不认 .tmTheme，直接忽略
把 .tmTheme 转成 ST4 兼容的 .sublime-color-scheme
不能简单改后缀。ST4 的 .sublime-color-scheme 是 JSON 格式，结构必须含 base_type、variables、rules 三层。手动重写极易出错，推荐两种方式：
• 用在线转换工具 tmTheme Editor（搜名字就能找到），上传原 .tmTheme 文件，导出为 .sublime-color-scheme，再放进 Packages/User/
• 找主题作者 GitHub 页面，看是否有 ST4 分支或新版 release（很多老主题如 Spacegray 已有适配版）
• 别把转换后的文件丢进 Packages/ 根目录——ST4 只认 Packages/User/ 或插件自带的 Packages/xxx/ 下的合法路径
修复 scope 不匹配导致的高亮失效
即使颜色方案加载成功，寄存器、指令、宏等词仍不着色，是因为旧主题里写的 scope 名（如 support.type.asm）在新语法包里已改成 support.instruction.x86_64 或 keyword.control.asm。验证方法：光标停在关键词上，Ctrl+Shift+P → Inspect Scope，看实际输出的 scope 名。然后：
• 打开你刚转好的 .sublime-color-scheme 文件
• 在 rules 数组里新增匹配项，例如：
{
"scope": "support.instruction.x86_64",
"foreground": "var(blue)"
}
• 不要删掉旧 rule——保留兼容性，新旧 scope 名可共存
• 缩进错一格整个文件就失效，保存前用 JSON 校验工具过一遍中文字体发虚、菜单繁简混杂怎么救
这跟主题无关，是 ST4 在 Windows 上默认启用 DirectWrite 渲染引擎，对某些中文字体（尤其微软雅黑变体）字形匹配错误。解决只需两行配置：
• 打开 Preferences → Settings - User
• 加入：
"font_options": ["gdi"], "theme_font_options": ["gdi"]• 保存后**必须完全退出 Sublime（任务管理器里确认无残留进程）再重启**，只关窗口不够
最易被忽略的是：ST4 加载颜色方案失败时完全静默，连控制台都不报错；而 Inspect Scope 输出的 scope 名大小写敏感、带点号、有层级，抄错一个字符就白改。动手前先备份原主题文件，改完别急着全量替换，用小范围 rule 测试效果。
