VSCode语义高亮基于LSP提供上下文感知的精准着色，通过语言服务器返回符号类型与修饰符，结合主题规则动态渲染。用户可配置editor.semanticTokenColorCustomizations自定义颜色，如设置函数为亮绿色、静态方法为特定色值。开发语言插件时需在server capabilities中声明semanticTokensProvider，定义types和modifiers的legend，并响应semanticTokens/full请求返回五元组编码的token数据。语义高亮优先于TextMate规则但与其共存，未支持时自动回退。调试命令Inspect Editor Tokens and Scopes可查看当前token信息。最终效果依赖主题对语义token的支持，需确保配置覆盖目标类型。
VSCode 的语义高亮并非简单依赖传统的正则匹配，而是基于语言服务器协议（LSP）提供的深层语法结构信息，实现更精准、上下文相关的代码着色。要真正理解并定制这一机制，需深入其语法着色引擎的工作原理与扩展方式。
语义高亮的底层机制
传统文本编辑器通常使用 TextMate 语法规则（基于正则表达式）进行语法着色，这种方式速度快但缺乏上下文感知能力。VSCode 支持语义高亮后，可在启用 LSP 的语言（如 TypeScript、Python via Pylance）中获取编译器或语言服务器返回的符号类型信息。
当语言服务器支持 semanticHighlighting 能力时，它会向 VSCode 返回每个标识符的语义类别，例如：
- 变量名（variable）
- 函数名（function）
- 类名（class）
- 属性（property）
- 参数（parameter）等
VSCode 根据这些语义标签结合主题定义的颜色规则，动态渲染出更准确的高亮效果。
自定义语义着色规则
用户可通过修改编辑器主题或添加自定义 token 颜色来影响语义高亮显示。在 settings.json 或主题文件中配置 editor.tokenColorCustomizations 和 editor.semanticTokenColorCustomizations 实现深度控制。
例如，想让所有函数调用显示为亮绿色，可添加如下配置：
"editor.semanticTokenColorCustomizations": {
"rules": {
"function": "#A6DA95",
"method": "#A6DA95",
"variable.declared": "#89DDFF"
}
}
支持的语义修饰符还包括：static、deprecated、declaration 等，组合使用能实现细粒度控制，如：
librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。
"function.static": "#DDBB66", "variable.readonly": "#C792EA"
语言扩展中的语义高亮实现
若你正在开发一个语言插件，可通过 Language Server 实现 textDocument/semanticTokens 请求来提供语义信息。服务器需返回编码后的 token 数组，包含每段文本的语义类型和修饰符。
关键步骤包括：
- 在 server capabilities 中声明 semanticTokensProvider
- 定义 legend：列出支持的所有类型（types）和修饰符（modifiers）
- 响应 $/textDocument/semanticTokens/full 请求，返回按行偏移编码的 tokens
编码格式为五元组：[line, char, length, typeIndex, modifiersIndex]，高效压缩大量 token 数据。
与 TextMate 规则的协同工作
语义高亮不会完全取代语法着色。在未启用 LSP 或服务器不支持语义高亮的语言中，VSCode 仍回退到 TextMate 规则。两者可共存，语义高亮优先级更高，覆盖基础语法着色。
开发者可通过调试命令 Developer: Inspect Editor Tokens and Scopes 查看当前光标位置的 token 类型、作用域层级及生效的颜色规则，便于排查着色问题。
基本上就这些。掌握语义高亮机制后，不仅能提升阅读体验，还能为语言工具开发提供更强的可视化支持。不复杂但容易忽略的是，颜色最终呈现依赖主题本身是否适配这些语义 token。确保所用主题或自定义配置覆盖了目标语义类型，才能看到预期效果。
