语法高亮失效主因是token未被识别，需先确认右下角语言模式是否为正确language ID（非Plain Text），再用Developer: Inspect Editor Tokens and Scopes验证scope匹配与token生成。
语法高亮没生效，90%不是插件坏了，而是 token 没被识别出来——Developer: Inspect Editor Tokens and Scopes 是唯一能确认问题根源的命令，别猜，直接查。
怎么确认当前代码真被识别为对应语言
右下角显示 Plain Text 或错误语言名（比如 .proto 文件显示 javascript），高亮就不可能触发。这不是插件问题，是 VS Code 根本没启动语法解析流程。
- 点击右下角语言标识，手动选对语言（如
protobuf、dotenv、vue） - 频繁出错？在
settings.json里加"files.associations"强制绑定：{"*.env.dev": "dotenv", "*.proto": "protobuf"} - 注意语言 ID 名称：DotENV 插件注册的是
dotenv，不是env；Volar 对应vue，不是vue-html - 单文件打开（没开文件夹/工作区）时，很多插件不加载——先打开整个项目再试
为什么装了插件还是没高亮：scope 匹配失败
editor.tokenColorCustomizations 只改颜色，不生成 token。你改了 "keyword"，但插件把函数名标成 support.function，那它根本不会变色。
- 必须用
Developer: Inspect Editor Tokens and Scopes查光标处的实际 scope 名（例如support.class.builtin.python） - scope 名要和主题里定义的完全一致，大小写、点号、层级都不能错
- 有些插件（如
hbenl.vscode-protobuf）支持 AST 解析，token 更准；而纯正则插件（如zxh404.vscode-proto3）常漏掉 import 或嵌套结构 - 自定义语法（
.tmLanguage.json）必须放在插件./syntaxes/下，并在package.json的contributes.grammars中声明路径
调试 colorHighlight 类插件：色块不出现的硬性开关
色块不显示，第一反应不该是重装插件，而是检查两个底层开关是否打开——它们关了，整个颜色装饰器系统就停摆。
-
color-highlight.enable必须为true（注意不是colorHighlight.enabled，旧配置名已弃用） -
editor.colorDecorators必须为true，这是 VS Code 控制所有颜色装饰器的总闸门 - JS/TS 字符串中颜色值要高亮，必须手动加
pattern规则，例如："pattern": ""#[0-9a-fA-F]{3,8}"|'#[0-9a-fA-F]{3,8}'|"rgb\([^)]+\)"" - v2.5.0+ 才支持
#RGBA（8 位 hex），老版本只能匹配{3,6}
自定义语法高亮插件开发时的必踩坑点
自己写 .tmLanguage.json 时，最容易卡在“写了但没生效”，原因往往不在语法本身，而在注册链断裂。
- 插件激活后才调用
vscode.languages.setTextDocumentLanguage()注册languageId，否则 token 不被编辑器识别 -
injectTo填的是目标语言 ID（如text.html.markdown），不是文件后缀；且不支持通配符，"*"无效 - 想在 Markdown 代码块里高亮 Zig，得确保原 Markdown 语法规则里定义了
meta.embedded.block.zig这个 scope，否则embeddedLanguages映射无处落脚 - 别在插件里
require('monaco-editor')——插件运行在 Electron 主进程，没有 Monaco 实例，必报Cannot find module 'monaco-editor'
真正卡住人的从来不是语法怎么写，而是 scope 名对不对、languageId 注册没注册、底层开关开没开——这些地方一错，再漂亮的 .tmLanguage.json 也是废纸。
