必须用Package Control安装Vue Syntax Highlight,手动下载zip会导致ImportError或白底黑字;因ST4要求插件通过Package Control注册生命周期,且手动版无vue_version配置、不支持<script setup lang="ts">,也无法自动绑定.vue后缀。

别去 GitHub 手动下载 zip 包,直接用 Package Control 安装 Vue Syntax Highlight,否则大概率白底黑字或控制台报 ImportError。
为什么不能手动下载 zip
Sublime Text 4(当前主流版本)不兼容老式手动安装方式:解压到 Packages/Vue/ 或改名放错目录,会导致插件无法加载;控制台会持续输出 ImportError: No module named 'sublime_plugin'。这不是你操作失误,是插件入口机制已变——必须通过 Package Control 注册生命周期。
- 手动下载的
vue-syntax-highlight-master是 2018 年旧版,无vue_version配置项,不支持<script setup lang="ts"> - 即使强行复制进
Packages/,Sublime 也不会自动启用它,右下角始终显示Plain Text - Package Control 安装的版本带正确元信息和 ST4 兼容初始化逻辑,手动方式绕不过这层
正确安装 Vue Syntax Highlight 的三步
必须严格按顺序执行,缺一不可:
审查 Vue 管理后台的变更请求(Vue 2 + Element UI,Vue 3 + Element Plus)。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package并回车 - 等待列表加载完成,**精确输入
Vue Syntax Highlight(首字母大写、中间空格、末尾带s和大写H)**,回车确认 - 安装后立刻检查:
Preferences → Browse Packages…目录下是否存在Vue Syntax Highlight/文件夹 —— 不是vuejs/、不是vue-component/、也不是VueSyntaxHighlight/(无空格)
装完还是 Plain Text?先查控制台
安装成功 ≠ 自动生效。如果打开 .vue 文件右下角仍显示 Plain Text,不是插件没装好,是 Sublime 没被告诉“这个后缀归谁管”:
立即学习“前端免费学习笔记(深入)”;
- 点击右下角
Plain Text→ 选Open all with current extension as…→ 找到并点击Vue Component(注意不是Vue、HTML或Vue Template) - 如果菜单里压根没有
Vue Component,说明插件根本没加载:按Ctrl+`打开控制台,看是否有ImportError;有则大概率旧插件冲突,需先用Package Control: Remove Package卸载VueJS或vue-component - 确认卸载干净后重试安装,别跳过“Browse Packages…”验证步骤
最常被忽略的一点:插件只提供语法定义文件 Packages/Vue Syntax Highlight/Vue.sublime-syntax,它不会、也不能自动绑定 .vue 后缀。这一步必须人手点一次,之后才会写入 User 设置里的 "syntaxes": {"vue": "Packages/Vue Syntax Highlight/Vue.sublime-syntax"} —— 没这行,整个高亮链就断在起点。

















