必须安装vue syntax highlight、手动绑定.vue后缀为vue component、配置vue_version为3并启用嵌套语法,三步缺一不可;否则.vue文件始终显示plain text,因sublime未识别其为vue文件。

装对插件、绑对后缀、配对嵌入规则,三步缺一不可;否则.vue文件永远是Plain Text——不是你操作错了,是Sublime压根没“认出”这是Vue文件。
必须安装 Vue Syntax Highlight,别装错名字
只有 Vue Syntax Highlight 这一个插件在 Sublime Text 4 下稳定支持 Vue 3(含 <script setup lang="ts"></script>)。其他名字相似的包基本失效:
-
VueJS或vue-component:已停更,控制台报ImportError: No module named 'sublime_plugin' -
Vuejs(少 s)或Vue Syntax Highlighter(多 r):拼写错误,加载失败 - 搜
vue syntax容易误选旧版,必须严格输入Vue Syntax Highlight(首字母大写、中间空格、末尾带 s)
装完检查 Preferences → Browse Packages… 下是否存在 Vue Syntax Highlight/ 文件夹(不是 vuejs/ 或 VueJS/)。
右下角必须手动设成 “Vue Component”
插件只提供语法定义文件 Packages/Vue Syntax Highlight/Vue.sublime-syntax,不会自动把 .vue 后缀和它关联。跳过这步,所有 .vue 文件永远显示为 Plain Text。
- 打开任意一个
.vue文件 - 点击右下角当前语法名(比如显示
Plain Text) - 选择
Open all with current extension as…→ 点击Vue Component(注意:不是Vue、HTML、Vue Template)
如果菜单里没出现 Vue Component,说明插件根本没加载成功——按 Ctrl+` 查控制台报错,常见原因是 Package Control 版本太旧,先升级它。
<script setup lang="ts"></script> 还是灰色?检查嵌入配置和子语言支持
Vue Syntax Highlight 本身不渲染 JS/TS/CSS,它靠 Sublime 的嵌入语法机制,把 <script></script> 块交给对应语言插件处理。灰色 ≠ Vue 插件坏了,而是子语言没接上。
- 确认已安装对应子语言插件:用 TypeScript 就得装
JavaScriptNext - ES6 Syntax或官方TypeScript插件;用 SCSS 就得装SCSS插件(作者 css415) - 进
Preferences → Package Settings → Vue Syntax Highlight → Settings,在 User 配置中确保:-
"vue_version": "3"(默认可能是"2",不改就无法识别defineProps、v-model:value等 Vue 3 特性) "enable_vue_blocks": true-
"enable_ts_in_script": true(不是enable_js_in_script) "enable_css_in_style": true
-
- 临时验证法:把
.vue文件后缀改成.js,看<script></script>区块是否恢复高亮——能恢复,说明问题出在 Vue 层解析,不是底层 JS/TS 插件失效
格式化和类型提示要额外配 CLI 工具链
Vue Syntax Highlight 只负责着色,不提供格式化、校验、跳转或类型推导。
- 格式化依赖
JsPrettier+prettier+prettier-plugin-vue:在JsPrettier用户配置中加"custom_file_extensions": ["vue"],并确保全局或项目内装了对应 npm 包 - 类型提示、错误诊断、自动补全需
SublimeLSP+Volar(不是已停更的Vetur):Volar 是 Vue 官方推荐的 LSP 客户端,defineProps、ref()等才能被识别为有效声明
别指望它像 VS Code 那样自动识别 setup 中的类型——Sublime 本身不带语言服务器(LSP)能力,这点得接受。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











