语义高亮异常需依次检查：启用editor.semanticHighlighting.enabled、确认语言扩展支持LSP语义令牌、验证主题适配性、禁用TextMate高亮以隔离问题。
如果您在VSCode中启用“Semantic Tokenization”后发现语法高亮未按预期变化，或部分语言元素（如变量名、类型名、修饰符）颜色与传统语法高亮不一致，则可能是由于语义标记未正确启用、语言服务器未支持或主题未适配语义着色。以下是解决此问题的步骤：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、确认语言服务器支持并启用语义高亮
语义高亮依赖语言服务器提供精确的符号分类信息，需确保所用语言扩展已实现LSP语义令牌（Semantic Tokens）协议，并在VSCode中显式启用。
1、打开VSCode命令面板（快捷键 Cmd+Shift+P）。
2、输入并选择“Preferences: Open Settings (JSON)”。
3、在 settings.json 中添加或确认存在以下配置项：
"editor.semanticHighlighting.enabled": true,
"editor.semanticTokenColorCustomizations": {}
4、重启VSCode或重新加载窗口（Cmd+Shift+P → “Developer: Reload Window”）。
二、检查当前语言扩展是否提供语义令牌
并非所有语言扩展都支持语义高亮；只有实现了LSP 3.16+语义令牌能力的语言服务器才能提供该功能，例如TypeScript、C#（OmniSharp）、Rust（rust-analyzer）、Python（Pylance）等。
1、打开命令面板，执行“Developer: Toggle Developer Tools”。
2、切换到Console标签页，输入“semantic”并回车，观察是否有类似“[Extension Host] Registered semantic tokens provider for typescript”日志。
3、若无相关日志，前往扩展市场搜索当前语言对应扩展的最新版本说明，确认其是否标注支持“Semantic Tokens”或“Semantic Highlighting”。
4、如不支持，可尝试切换至官方推荐扩展：TypeScript：使用内置TypeScript and JavaScript Language Features；Python：必须安装Pylance而非仅Python扩展。
三、验证并自定义语义着色规则
VSCode默认使用主题内置的语义着色映射，但部分第三方主题可能未定义全部语义修饰符（如readonly、deprecated、defaultLibrary），导致某些符号未高亮或颜色异常。
1、打开设置（Cmd+,），搜索“semantic token color customizations”。
2、点击“Edit in settings.json”，在"editor.semanticTokenColorCustomizations"对象内添加scope映射，例如：
"editor.semanticTokenColorCustomizations": {
"enabled": true,
"rules": {
"variable.readonly:java": "#8080ff",
"type.builtin.go": "#00aaff"
"}
}
3、保存后，打开对应语言文件，观察目标符号是否生效；注意：scope名称区分大小写且须与语言服务器实际发布的token类型完全一致。
四、禁用传统TextMate语法高亮以排除干扰
当语义高亮与TextMate语法高亮同时启用时，VSCode会按优先级合并两者结果，可能导致部分元素被覆盖或颜色冲突。临时禁用TextMate高亮有助于独立验证语义高亮效果。
1、打开命令面板，执行“Preferences: Configure Language Specific Settings…”。
2、选择当前文件语言（如“TypeScript”）。
3、在弹出的JSON块中添加：
"editor.tokenColorCustomizations": {
"textMateRules": []
"}
4、保存并重开文件；此时仅语义标记生效，若高亮消失，说明该语言当前未返回有效语义令牌。
