必须安装vue syntax highlight插件(首字母大写、中间空格、末尾带s和大写h),手动绑定.vue后缀为vue component,配置"vue_version":"3"、"enable_ts_in_script":true及"enable_vue_blocks":true,否则.vue文件始终显示plain text且script/style区块无高亮。

装 Vue Syntax Highlight 插件,别输错名字
Sublime Text 默认不识别 .vue 文件,装错插件是高亮全黑或断裂的主因。唯一当前持续维护、支持 <script setup></script> 和 lang="ts" 的插件,只有 Vue Syntax Highlight(注意:首字母大写、中间空格、末尾带 s 和大写 H)。
常见错误包括:
- 搜
vue或vuejs装到已停更的VueJS(只支持 Vue 2,ST4 上报ImportError: No module named 'sublime_plugin') - 装
vue-component(ST2 专用,在 ST4 直接崩溃) - 少输一个
s,比如Vue Syntax Highlight写成Vue Syntax Highlight(旧版不兼容)
实操建议:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package回车 - 等待列表加载完成,**严格输入
Vue Syntax Highlight**,回车安装 - 装完后进
Preferences → Browse Packages…,确认存在Vue Syntax Highlight/文件夹(不是vuejs/或vim-vue/)
手动绑定 .vue 后缀为 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)或Vue Template)
如果菜单里没出现 Vue Component,说明插件根本没加载成功——按 Ctrl+` 查控制台是否有报错;常见原因是 Package Control 版本太旧,先升级再重试。
<script setup lang="ts"></script> 仍是灰色?检查嵌套语法链
Vue Syntax Highlight 本身不渲染 JS/TS,它靠 Sublime 的嵌入语法机制,把 <script></script> 块交给对应语言插件处理。灰色 ≠ Vue 插件坏了,是子语言没接上。
关键配置点:
- 确认已安装
JavaScriptNext - ES6 Syntax(推荐)或官方TypeScript插件;装完开一个.ts文件,右下角应显示TypeScript - 进
Preferences → Package Settings → Vue Syntax Highlight → Settings,在 User 配置中确保含:"enable_ts_in_script": true(不是enable_js_in_script)"vue_version": "3"(老版本默认"2",会导致组合式 API 高亮断裂)"enable_vue_blocks": true
临时验证法:把文件后缀改成 .ts,看 <script></script> 区块是否恢复高亮——能恢复,就说明问题出在 Vue 层解析,不是底层 TS 插件失效。
保存时自动格式化 .vue 文件为什么无效
Sublime Text 本身不带格式化能力。“保存即格式化”必须依赖外部工具(如 prettier)+ 插件桥接,而 .vue 的多块结构会让配置更脆弱。
常见失效原因:
-
JsPrettier没指定--parser vue,导致 template 块被当成 HTML 格式化失败 -
SublimeLinter-eslint项目级配置缺失parser: 'vue-eslint-parser',或未启用plugin:vue/vue3-essential - 全局安装的
prettier路径未被 Sublime 正确识别,建议用npm install --save-dev prettier prettier-plugin-vue本地安装
实操建议(以 JsPrettier 为例):
- 在
JsPrettier用户配置中加:"auto_format_on_save": true"additional_cli_args": {"--parser":"vue","--vue-html-indent":"2"} - 确保项目根目录有
prettier.config.js,且含plugins: ['prettier-plugin-vue']
复杂点在于:template/script/style 三块需不同解析器协同工作,任一环节断链,格式化就会局部失效或报错——这不是配置遗漏,是 Sublime 的语法嵌入模型天然限制,得靠配置逐层对齐。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











