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" } }

• 它不改语法解析，只做“视觉叠加”，所以不会影响括号匹配、缩进或 LSP 功能
• 缺点：无法区分上下文（比如同一个词在字符串里也被高亮），且不支持作用域嵌套（如不能只高亮函数参数里的变量）

改 editor.tokenColorCustomizations 却没反应

这是最常踩的坑——规则写了，颜色没变。根本原因通常是 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 可能被多个机制同时影响，调颜色前先得把这条链路理清楚。