必须安装Vue Syntax Highlight插件、手动绑定.vue后缀为Vue Component、配置vue_version为3并启用子语言嵌入开关,三步缺一不可;否则.vue文件始终显示Plain Text且区块无高亮。

Vue 语法高亮不全,不是插件“没起作用”,而是 Sublime Text 没把 .vue 文件真正识别为 Vue 组件——它压根没调用语法解析器,Plain Text 状态就是最直接的证据。
右下角显示 Plain Text,说明语法根本没加载
这是最常见也最容易被误判的问题。Sublime 不会自动把 .vue 后缀和任何语法绑定,装了插件 ≠ 文件被解析。
- 打开任意一个
.vue文件,点击右下角当前语法名(比如Plain Text) - 选择
Open all with current extension as…→ 找到并点击Vue Component(注意:不是Vue、HTML或Vue Template) - 如果菜单里根本没有
Vue Component,说明插件未加载成功,按Ctrl+`查控制台是否有ImportError: No module named 'sublime_plugin'—— 这基本是装了旧包(如VueJS或vue-component)导致的冲突 - 已装错包?进
Preferences → Package Settings把它禁用,再用Package Control: Remove Package卸干净
装对插件名:Vue Syntax Highlight(带 s 和大写 H)
Package Control 搜索时拼错一个字母,就会装到停更或不兼容的旧包,直接导致 <script setup lang="ts"></script> 块全灰、defineProps 不高亮。
- 必须严格输入
Vue Syntax Highlight:首字母大写、中间空格、末尾带s和大写H - 别搜
vue syntax或vue highlight,容易选到vue-component(已停更)或VueJS(ST2 旧包) - 装完检查
Preferences → Browse Packages…下是否存在Vue Syntax Highlight/文件夹(不是vuejs/) - ST4 安装后建议执行
Ctrl+Shift+P → Reload Syntax Definitions,比重启更快生效
<script setup lang="ts"></script> 还是灰色?子语言链断了
Vue Syntax Highlight 本身不渲染 JS/TS/CSS,它只做“分块”和“嵌入声明”,真正的着色靠其他语言插件完成。灰色 = 子语言没接上,不是 Vue 插件坏了。
立即学习“前端免费学习笔记(深入)”;
- 确认已安装对应语言插件:
TypeScriptSyntax(注意名称含全角空格)或JavaScriptNext - ES6 Syntax;SCSS 用SCSS(作者css415) - 单独打开一个
.ts或.scss文件,确认右下角显示的是TypeScript或SCSS,不是Plain Text - 进
Preferences → Package Settings → Vue Syntax Highlight → Settings,User 配置中确保有:
{
"vue_version": "3",
"enable_ts_in_script": true,
"enable_css_in_style": true,
"enable_vue_blocks": true
}
.vue 文件后缀改成 .ts,看 <script></script> 区是否恢复高亮——能恢复,就坐实是 Vue 层解析失败为什么 <style scoped lang="scss"></style> 里颜色还是不对?
即使 SCSS 插件已装、enable_css_in_style 已开,<style></style> 块仍可能只按普通 CSS 高亮,原因是嵌入 scope 没匹配上。
- 检查当前主题是否定义了
source.css.scss或source.css.postcss等 scope:光标停在 SCSS 关键词上,按Ctrl+Shift+P → Inspect Scope,看输出的 scope 名 - 打开当前主题文件(路径类似
Packages/User/xxx.tmTheme),搜索该 scope —— 如果没匹配到,主题就没覆盖它,会回落成默认灰 - 绕过方法:换用
Monokai或Adaptive这类广泛适配的主题,快速验证是否主题问题 - 别手动改
Vue.sublime-syntax文件——它自带嵌入声明,改错会导致整个语法崩溃
最常被忽略的点:三步必须全部完成——装对插件、手动绑定 .vue 到 Vue Component、配好 vue_version 和子语言开关。缺一不可,且顺序不能乱;其中绑定后缀这步,90% 的人第一次都会跳过。


















