安装对应语言扩展是最快生效的方式，VSCode默认仅支持主流语言，其他语言需扩展提供tmLanguage.json语法定义，否则显示为“Plain Text”；需通过扩展面板安装、手动关联文件扩展名、检查scope匹配及自定义token颜色来确保高亮正确。
安装对应语言扩展是最快生效的方式
绝大多数语言的语法高亮不需要自己写插件，直接装现成扩展就能用。VSCode 默认只对 JavaScript、Python、HTML 等主流语言开箱即用，其他语言（比如 Rust、Elixir、TOML、.env）必须靠扩展提供 tmLanguage.json 语法定义文件。
常见错误现象：打开 .rs 文件显示为“Plain Text”，没有颜色；右下角语言模式是“Detect language automatically”或灰色文字——说明 VSCode 根本没识别出这是什么语言。
- 打开扩展面板（Ctrl+Shift+X），搜语言名，如
Rust、Toml、dotenv - 优先选作者是官方团队或 GitHub stars > 1k、最近半年有更新的扩展
- 安装后，重新打开同名文件，或点击右下角语言名 → “Reopen with Language Mode” → 选对应语言
- 若仍不生效，检查文件扩展名是否在扩展的
contributes.languages.extensions列表里（可看扩展 package.json 或 README）
手动关联文件扩展名才能让高亮真正稳定
即使装了扩展，VSCode 也可能因为扩展未声明某扩展名，或你用了自定义后缀（如 .myconf），导致高亮失效。这时候不是插件有问题，而是“文件没被归类到该语言”。
典型场景：写了个配置脚本叫 deploy.mylang，但扩展只注册了 .mlang；或者你用 .adoc 写 AsciiDoc，但默认识别成“Plain Text”。
- 打开任意一个目标文件（如
config.mylang） - 点击右下角语言标识（例如显示“Plain Text”）
- 选“Configure File Association for '.mylang'...”
- 输入语言名（如
My Language），或从下拉列表选已安装语言 - 此操作会向
settings.json写入"files.associations"条目，影响全局
自定义高亮颜色必须用 textMateRules + scope 名称
想改某个语法元素的颜色（比如把所有函数名变紫色），不能靠瞎猜 scope，必须先确认当前光标位置的真实作用域。VSCode 的高亮依赖 TextMate 语法引擎输出的 scope 链，比如 support.function.builtin.python 是比 support.function 更精确的匹配路径。
常见坑：直接抄网上示例里的 "scope": "keyword"，结果没效果——因为实际 scope 可能是 keyword.control.if.python，而更宽泛的 keyword 被更高优先级规则覆盖了。
- 按 Ctrl+Shift+P，运行
Developer: Inspect Editor Tokens and Scopes - 把光标放在想改色的代码上（如一个
for关键字），看弹窗里 “Scope” 字段的完整值 - 在
settings.json的editor.tokenColorCustomizations.textMateRules里加规则 - scope 值越长越精准，优先用带语言后缀的（如
keyword.control.python），避免误匹配 - background 字段在部分语言服务器中不生效，优先试
foreground和fontStyle
自己写插件支持小众语言时，tmLanguage.json 是核心
如果你的语言完全没有现成扩展（比如公司内部 DSL、自制脚本语言），就得自己写插件。关键不是写 TypeScript 逻辑，而是提供正确的 tmLanguage.json ——它本质是一堆正则匹配规则，VSCode 用它做词法分析，不涉及语义。
容易被忽略的一点：scope 名称不是随便起的，它决定了后续能否被主题或 tokenColorCustomizations 正确捕获。起名要遵循 TextMate 社区惯例，比如字符串用 string.quoted.double，注释用 comment.line.number-sign。
-
package.json中必须声明contributes.grammars，指向你的.tmLanguage.json文件 -
scopeName字段要唯一且带语言标识，如source.mylang，不能是source这种泛化名 - 正则里用
\b匹配单词边界，避免if匹配到interface；用非贪婪".*?"匹配字符串 - 测试时不要只看颜色，用
Inspect Editor Tokens确认 scope 是否按预期输出，这是调试唯一可靠手段
