必须安装Vue Syntax Highlight(首字母大写、空格、末尾带s和大写H),手动绑定.vue为Vue Component语法,并在User Settings中配置"vue_version":"3"、"enable_ts_in_script":true等嵌入开关,三步缺一不可;否则.vue文件全为Plain Text或嵌套区块无高亮。

Vue Syntax Highlight 必须装对名字,否则嵌套高亮直接失效
装错插件是嵌套高亮不工作的头号原因。Sublime 原生不识别 .vue,所有高亮都靠插件提供语法定义,而当前唯一兼容 ST4、持续维护、支持 <script setup lang="ts"></script> 和 <style scoped lang="scss"></style> 的插件,只有 Vue Syntax Highlight(注意:首字母大写、中间空格、末尾带 s 和大写 H)。
常见错误包括:
- 搜
vue或vuejs装到已停更的VueJS插件,控制台报ImportError: No module named 'sublime_plugin' - 装
vue-component(ST2 专用),在 ST4 下无法加载,defineProps()等 API 完全无高亮 - 少输一个
s,比如写成Vue Syntax Highlight(旧版),与 ST4 不兼容
验证是否装对:打开 Preferences → Browse Packages…,确认存在 Vue Syntax Highlight/ 文件夹;若看到的是 vuejs/ 或 vim-vue/,说明装错了,需先禁用再重装。
必须手动绑定 .vue 后缀为 Vue Component 语法
插件只提供 Packages/Vue Syntax Highlight/Vue.sublime-syntax 文件,不会自动把 .vue 后缀和它挂钩——这步跳过,<template></template> <script></script> <style></style> 全部显示为 Plain Text,嵌套高亮根本无从谈起。
立即学习“前端免费学习笔记(深入)”;
实操步骤:
- 打开任意一个
.vue文件 - 点击右下角当前语法名(如显示
Plain Text) - 选择
Open all with current extension as…→ 点击Vue Component(注意不是Vue、HTML或Vue Template)
如果菜单里压根没出现 Vue Component,说明插件根本没加载成功,按 Ctrl+` 查控制台报错;常见原因是 Package Control 版本太旧,先升级再重试。
嵌套语法开关必须在 User Settings 中显式开启
Vue Syntax Highlight 本身不渲染 JS/TS/CSS,它靠 Sublime 的嵌入语法(embedded syntax)机制,把 <script></script> 块交给 TypeScript 插件、把 <style></style> 块交给 SCSS 插件处理。灰色 ≠ Vue 插件坏了,是嵌入链断了。
进 Preferences → Package Settings → Vue Syntax Highlight → Settings,在右侧 User 配置中,确保包含以下内容:
{
"vue_version": "3",
"enable_vue_blocks": true,
"enable_ts_in_script": true,
"enable_css_in_style": true
}关键点:
-
"vue_version": "3"必须设为字符串"3",默认可能是"2",会导致defineProps、withDefaults等组合式 API 高亮断裂 - 用
enable_ts_in_script,不是enable_js_in_script;用 TS 就必须开这个 - 别改
Vue.sublime-syntax文件——它自带嵌入声明,手改极易导致整个语法崩溃
子语言插件必须单独安装并验证生效
嵌套高亮最终依赖底层语言插件。即使 Vue 配置全对,如果没装或没启用对应子语言支持,<script setup lang="ts"></script> 还是灰色,<style lang="scss"></style> 也不会有 SCSS 高亮。
必须确认:
- 用 TypeScript:已安装
JavaScriptNext - ES6 Syntax(推荐)或官方TypeScript插件,并打开一个.ts文件,右下角显示TypeScript - 用 SCSS:已安装
SCSS插件(作者css415),并打开一个.scss文件确认右下角显示SCSS - 临时验证法:把
.vue文件后缀临时改成.js,看<script></script>区块是否恢复高亮——能恢复,说明问题出在 Vue 层解析,不是 JS/TS 插件失效
最易被忽略的是:子语言插件装了但没验证是否真正生效。很多人卡在“Vue 配置全对,就是 script 块不亮”,结果发现 .ts 文件右下角还是 Plain Text ——嵌入链的第一环就断了。


















