vs code语法高亮“消失”主因是语言模式错配、语义缓存卡住或token颜色被插件覆盖；右下角显示plain text需优先检查，确认后缀、files.associations及jsconfig.json/tsconfig.json存在。
语法高亮“消失”绝大多数时候不是主题文件损坏，而是 VS Code 根本没启动对应语言的着色流程——语言模式错配、语义缓存卡住、或 token 颜色配置被插件悄悄覆盖，这三类问题占实际故障的 90% 以上。
右下角显示 Plain Text 就别调主题了
这是最常见也最该优先检查的一环。VS Code 不分析文件内容，只靠后缀名 + files.associations + 手动切换结果来决定用哪种语法解析器。一旦状态栏显示 Plain Text，整个高亮链就断了。
- 点击右下角语言标识，输入
javascript react或typescript（注意不是基础javascript）并回车确认 - 检查文件后缀是否拼错：比如
.jss、.ts_、.JS（部分扩展对大小写敏感） - 刚克隆的项目，确保根目录有
tsconfig.json或jsconfig.json（空文件也行），否则Volar/Pylance不加载语义层 - 搜
@builtin javascript或@builtin python，确认内置语言扩展状态为「已启用」
高亮全灰但语言模式是对的
语言标识正确却无颜色，说明 token 生成或着色环节被阻断。不是主题坏了，而是 TextMate 规则没命中，或语义缓存错位。
- 按
Ctrl+Shift+P运行Developer: Inspect Editor Tokens and Scopes，把光标停在不亮的const上，看 scope 链里有没有类似keyword.control.js的项；若只有keyword，说明主题规则太简陋 - 删掉缓存目录：
%APPDATA%\Code\Cache\semantic-tokens\（Windows）或$HOME/.vscode/Cache/semantic-tokens/（macOS/Linux），然后**完全退出 VS Code 进程**再重开 - 检查
settings.json是否被插件注入了空的"editor.tokenColorCustomizations": {}——Bracket Pair Colorizer等插件常偷偷写这个，直接删掉整段 - 临时关语义高亮验证：
"editor.semanticHighlighting.enabled": false，如果此时基础关键字恢复颜色，说明是语义层和主题不兼容
切换主题后高亮“残留”或变灰白
VS Code 1.80+ 默认启用语义高亮，它会把 function、parameter 等语义类型连同颜色一起缓存在磁盘。主题换了，缓存没清，旧颜色就还在用。
- 必须完全退出 VS Code：关闭所有窗口，再确认进程已退出（macOS/Linux 查
ps aux | grep code，Windows 任务管理器看Code.exe） - 第三方主题（如
Nord、Dracula）往往只定义了keyword、string、comment几条通用规则，遇到variable.other.readwrite.ts就 fallback 到默认前景色（常为白色） - 切回
Default Dark+测试：如果#include变橙、<script></script>变蓝，说明当前主题缺规则，不是文件或扩展问题 - 补色最稳的方式是手动加
textMateRules，例如为 HTML 标签加entity.name.tag.html，scope 名必须从Inspect Editor Tokens面板里复制，不能凭印象手写
真正需要怀疑主题文件损坏的情况极少——除非你手动编辑过 themes/*.json 并保存了语法错误的 JSON，或者安装了来源不明的修改版主题包。绝大多数所谓“主题损坏”，其实是语义缓存未清、scope 匹配失败、或插件劫持了 tokenColorCustomizations。这些点都排查完，再考虑重装主题也不迟。
