右下角显示 plain text 说明高亮已失效,需手动设置语法或配置扩展名绑定;缺插件、语法包不匹配、主题未定义 scope 或缓存未刷新也会导致高亮异常。

右下角显示 Plain Text 就说明高亮已失效
这不是 Bug,是 Sublime Text 的默认行为:它不会为未识别语言的文件启用任何语法着色。一旦状态栏右下角显示 Plain Text,所有高亮逻辑就停止了——连注释、字符串都不会变色。
解决方式极其直接:
- 点击右下角的
Plain Text,从菜单里选对语言,比如JavaScript、Vue Component或XML - 快捷键更快:
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Set Syntax: JavaScript回车 - 该操作只影响当前文件;若想永久绑定扩展名(如所有
.vue文件都用 Vue 语法),选完后执行View → Syntax → Open all with current extension as…
Vue/TS/JSX 高亮异常大概率缺插件或配错语法包
Sublime Text 自带的 JavaScript 语法不支持 Vue SFC、TypeScript 类型标注或 JSX,这些必须靠第三方 .sublime-syntax 或 .tmLanguage 文件补全。
常见踩坑点:
-
Vue Syntax Highlight插件装了但没生效?确认你用的是new分支(对应 Sublime Text ≥3153),master分支在新版里会漏掉<script setup></script>和箭头函数事件处理器 - Vue 里的
<script lang="ts"></script>块不亮?除了装TypeScript插件,还得确保ignored_packages设置里没禁用它(检查Preferences → Settings中是否含"TypeScript") - JSX 写在
<script></script>里完全无高亮?装Babel插件,并在Preferences → Package Settings → Babel → Settings里确认启用了jsx支持
高亮颜色错乱或部分失效,先查主题是否覆盖了 scope
语法高亮 = 语法包定义 scope(如 keyword.control.js) + 主题定义 color_scheme(如 monokai.tmTheme)。两者断一环,颜色就出问题。
快速验证方法:
- 把光标停在某个关键词上,按
Ctrl+Shift+P输入Inspect Scope,看控制台输出的 scope 名称(例如support.type.object.console.js) - 打开当前主题文件(路径通常在
Packages/User/xxx.tmTheme),搜索该 scope —— 如果没匹配到,主题就没定义它,会回落到默认灰 - 临时绕过:换一个广泛适配的主题,比如
Monokai或Adaptive,看是否恢复;若恢复,就是原主题太旧或 scope 覆盖不全
重启、重载、删缓存不是玄学,是真实生效步骤
Sublime Text 加载语法包有缓存机制,尤其装完新插件或改完配置后,不强制刷新,改动常不生效。
必须做的三件事:
- 装完插件后,执行
Ctrl+Shift+P → Reload Syntax Definitions(比重启轻量,且能立即生效) - 如果
Reload不管用,彻底退出 Sublime Text(包括系统托盘进程),再重开——某些插件只在启动时注册语法 - 长期异常?删掉
Packages/User/Package Control.cache和Local Cache.sublime-package(路径见知识库),清除语法索引后首次启动会慢一点,但能排除映射错乱
别跳过 reload 这步。很多“装了插件却没高亮”的问题,卡在这儿。











