必须安装vue syntax highlight插件（名字严格为“vue syntax highlight”）、手动绑定.vue后缀为vue component、配置"vue_version": "3"并启用enable_ts_in_script等嵌入开关，三步缺一不可；装错插件或跳过任一步均导致白底黑字或控制台报importerror。
装错插件名会导致控制台报 ImportError: No module named 'sublime_plugin'
Sublime Text 4 下唯一能用的 Vue 高亮插件是 Vue Syntax Highlight，名字必须严格匹配：首字母大写、中间空格、末尾带 s。搜 vue syntax 或 vue highlight 极易误选已停更的 VueJS 或不兼容的 vue-component，它们会在控制台抛出 ImportError: No module named 'sublime_plugin'。
正确操作路径：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成，**精确输入
Vue Syntax Highlight**（大小写、空格、复数 s 缺一不可） - 安装后检查
Preferences → Browse Packages…目录下是否存在Vue Syntax Highlight/文件夹（不是vuejs/或vue-component/）
如果已装错，先用 Package Control: Remove Package 卸载旧包，再重试。
不手动绑定 .vue 后缀，永远显示 Plain Text
插件只提供语法定义文件 Packages/Vue Syntax Highlight/Vue.sublime-syntax，不会自动把 .vue 后缀和它关联。跳过这步，所有 .vue 文件右下角始终显示 Plain Text，不是插件没生效，是 Sublime 根本没调用它。
绑定方法：
- 打开任意一个
.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> 块交给对应语言插件处理。所以 <script setup lang="ts"></script> 灰色，90% 是嵌入规则没生效，不是 Vue 插件问题。
必须确认三件事：
- 进
Preferences → Package Settings → Vue Syntax Highlight → Settings，确保有"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 - 已单独安装对应子语言插件：TS 需
TypeScriptSyntax或官方TypeScript插件；SCSS 需作者css415的SCSS插件；且单独打开一个.ts或.scss文件，确认右下角显示对应语法名
临时验证法：把 .vue 文件后缀改成 .ts，看 <script></script> 区块是否恢复高亮——能恢复，说明是 Vue 层解析失败，不是 Sublime 整体崩溃。
别指望它做语义提示或跳转
Vue Syntax Highlight 只负责着色，不提供类型推导、符号跳转、补全或错误检查。如果你需要 defineProps 参数提示、ref 类型推导或模板中组件名跳转，得另装 LSP-Volar 或 Vue Completions 等插件，但它们和语法高亮是两套独立机制。
最容易被忽略的一点：即使所有配置都对，只要 Preferences → Package Settings → Vue Syntax Highlight → Settings – User 里漏了 "vue_version": "3"，<script setup></script> 就永远是灰的——这个字段不是可选，是硬性开关，且必须是字符串 "3"，不能是数字 3 或空值。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
