VSCode通过插件实现自定义语法高亮-VSCode-PHP中文网

vscode识别新文件类型需先手动设置语言模式，再通过files.associations配置永久关联；高亮失效常见原因是语言id不匹配、插件未提供语法定义或语义高亮覆盖textmaterules。

vscode通过插件实现自定义语法高亮

VSCode 默认不认识 .mycfg、.tmpl 或自定义后缀，直接打开就是“纯文本”，没有高亮。关键不是写规则，而是先让编辑器“认出它是什么语言”。

最简方式：打开该文件 → 点击右下角语言标识（如“Plain Text”）→ 输入目标语言名（如 json、yaml、javascript）→ 回车确认
永久生效：在 settings.json 中加 "files.associations" 规则，例如：
```
"files.associations": { "*.mycfg": "ini", "*.tmpl": "html" }
```
注意：关联语言必须已安装对应扩展（比如 ini 依赖内置支持，html 默认有，但 terraform 就得装 HashiCorp 官方插件）

常见原因是语言模式没对上，或者插件根本没提供语法定义。很多插件只做 LSP（代码补全/跳转），不带 .tmLanguage.json 高亮规则。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

检查当前文件右下角显示的语言 ID 是否与插件声明的一致（比如 Rust 插件注册的是 rust，不是 Rust 或 rs）
用 Ctrl+Shift+P 执行 Developer: Inspect Editor Tokens and Scopes，看顶部是否出现带语言后缀的 scope（如 source.rust）；若只有 text.plain，说明语言未正确激活
部分插件需手动启用语法高亮（如某些 YAML 插件默认关闭高亮，在其设置里找 yaml.format.enable 或类似开关）

不想开发完整扩展？可以用 Highlight 或 Highlight Words 这类轻量插件实现关键词级高亮，适合配置文件、日志或 DSL 片段。

Highlight 插件支持正则匹配 + 自定义颜色，例如高亮所有 TODO 或 FIXME：

"highlight.regexes": { "(TODO|FIXME)": { "filterFileRegex": "\.js$|\.ts$", "decoratorName": "highlight.todo" } }

这是最常踩的坑——规则写了，颜色没变。根本原因通常是 scope 写错、层级放错，或被语义高亮覆盖。

scope 必须精确：查到的是 variable.other.property.js，就不能只写 variable；用 Developer: Inspect Editor Tokens and Scopes 抓到哪个就用哪个
结构必须完整：外层是 "editor.tokenColorCustomizations"，里面是 "textMateRules" 数组，缺一层就失效
语义高亮优先级更高：如果 "editor.semanticHighlighting.enabled": true，且语言服务器返回了 variable 类型信息，那么 textMateRules 里同名 scope 的 foreground 可能被忽略（背景色仍有效）
主题限制：某些主题禁用装饰（editor.decorations 设为 false），会导致所有高亮规则失效

真正难的不是写几行 JSON，而是搞清当前高亮到底走哪条路径：是 TextMate 词法解析？LSP 语义分析？还是插件叠加装饰？混在一起时，一个 scope 可能被多个机制同时影响，调颜色前先得把这条链路理清楚。