必须右下角点击两次：第一次选目标语法（如Vue Component）仅临时生效，第二次再点该语法名并选“Open all with current extension as…”才完成全局绑定，跳过第二步则插件白装。
右下角点两次才能让新语法真正生效
装完插件只是“有了能力”，不是“自动启用”。Sublime Text 默认对未知扩展名一律当 Plain Text 处理，它不会猜你写的是什么语言。所以即使你装了 Vue Syntax Highlight 或 Protocol Buffer 插件，打开 .vue 或 .proto 文件后右下角仍显示 Plain Text，是完全正常的——根本原因就是没绑定。
必须手动触发两步：
- 第一次点击右下角当前语法名（比如
Plain Text）→ 选目标语法（如Vue Component或Protocol Buffer），只对当前文件临时生效 - 再次点击右下角（此时显示已选的语法名）→ 选
Open all with current extension as…→ 确认同一语法，这才完成全局绑定
跳过第二步，等于白装。很多用户卡在这一步，反复重装插件也没用。
别手写 extensions 映射，除非你清楚配置位置
直接编辑 Packages/User/Preferences.sublime-settings 并加 "extensions": ["proto"] 是常见错误。Sublime 会忽略这种全局写法——它只接受按语法包隔离的配置。
正确路径是：
- 先用上面“右下角两次点击”方式为某个扩展名设一次默认
- Sublime 会自动生成对应语法包的专属设置文件，例如
Packages/User/Vue Syntax Highlight.sublime-settings - 再去这个文件里加其他扩展名：
"extensions": ["vue", "vdx"]
如果硬要手写，syntax 字段必须严格为 "Packages/Vue Syntax Highlight/Vue.sublime-syntax" 这种完整路径，大小写、斜杠、后缀名（.sublime-syntax）全错不得。
.sublime-syntax 文件放错目录就加载失败
手动写的语法定义（比如自己写的 MyLang.sublime-syntax），必须放在 Packages/User/ 目录下，不能放在 Packages/ 根目录或子文件夹里。
验证是否加载成功：
- 重启 Sublime Text（ST4 有时需重启才读取新语法）
- 按
Ctrl+Shift+P输入Set Syntax，看菜单里有没有你的语言名 - 打开对应文件，按
Ctrl+Alt+P查看当前作用域，应显示类似source.mylang
常见失败点：YAML 缩进不一致、file_extensions 写成 .myl（带点）、scope 值和主题不匹配导致无颜色。
插件名拼错、版本不匹配，语法根本不会注册
搜 Vue 装到 VueJS 或 vue-component，右下角就不会出现 Vue Component 选项；搜 protobuf 装成非 xwmx 或 bennettp123 维护的版本，syntax = "proto3" 和 map<string, int32> 就解析不了。
检查方法：
- 菜单 →
Preferences → Browse Packages…→ 看对应文件夹是否存在（如Vue Syntax Highlight/） - 按
Ctrl+`打开控制台，启动时有无ImportError: No module named 'sublime_plugin' - 已装错包？进
Preferences → Package Settings把旧插件禁用，否则语法冲突会导致高亮降级
最麻烦的不是不会配，是配了但插件压根没加载——这时候再怎么点右下角都没反应。
