VS Code切换主题后代码变灰白主因是语义高亮缓存未清、TextMate scope匹配失败或扩展劫持tokenColorCustomizations；需运行Developer: Inspect Editor Tokens查scope、清semantic-tokens缓存、检查并删除被插件注入的空tokenColorCustomizations配置，同时确认语言模式正确。
VS Code 切换主题后代码变灰白、关键字不着色，不是主题“坏了”，而是语义高亮缓存没清、TextMate scope 没匹配上，或扩展劫持了 editor.tokenColorCustomizations —— 这三类问题占实际故障的 90% 以上。
为什么 Dark+ 能亮，但 GitHub Dark 全白？
主题本身没问题，问题出在 token scope 覆盖率。内置主题（如 Dark+）的 tokenColors 数组通常包含 30+ 条规则，覆盖 support.type.property-name、meta.interface.ts 等 TS/JS 特有 scope；而很多第三方主题只写了 comment、string、keyword 这几条通用规则，遇到 const 在 TypeScript 中被识别为 variable.other.readwrite.ts 就直接 fallback 到默认前景色（常为白色）。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Inspect Editor Tokens，把光标停在不亮的const上，看右下角显示的 scope 链里有没有带.ts或.js后缀 - 如果 scope 是
keyword→ 主题规则缺失或被覆盖；如果是variable.other.readwrite.ts→ 主题根本没定义这条，得手动补或换主题 - 检查当前主题包的
package.json里contributes.themes[0].path指向的 JSON 文件，确认tokenColors数组长度是否 ≥25
切换主题后高亮“残留”：清 semantic-tokens 缓存
VS Code 1.80+ 默认启用语义高亮，它会把 function、parameter 等语义类型连同颜色一起缓存在磁盘。主题换了，缓存没清，旧颜色就还在用——比如从 Dark+ 切到 Nord，async 还是蓝色，而 Nord 本该给它青色。
- 必须完全退出 VS Code：关闭所有窗口，再确认进程已退出（macOS/Linux 查
ps aux | grep code，Windows 任务管理器看Code.exe） - 删掉对应路径：
macOS/Linux：$HOME/.vscode/Cache/semantic-tokens/
Windows：%APPDATA%\Code\Cache\semantic-tokens\ - 重启 VS Code，打开文件，等几秒——语义 token 会重新生成并按新主题着色
- 不想每次都删？临时关掉语义高亮：
"editor.semanticHighlighting.enabled": false，但注意 Python/TS 会退化成基础语法高亮
扩展偷偷改了 editor.tokenColorCustomizations
像 Bracket Pair Colorizer、Indent Rainbow 这类 UI 增强插件，会在启动时往 settings.json 的 editor.tokenColorCustomizations 里写空对象或覆盖规则，导致主题原始配置被吞掉。现象是：状态栏语言 ID 正确、缓存已清、scope 也对，但就是不亮。
- 打开
settings.json，搜索tokenColorCustomizations，如果看到类似"editor.tokenColorCustomizations": { "textMateRules": [] }这种空数组，直接删掉整段 - 检查已启用扩展列表，禁用名字含
highlight、colorize、rainbow的插件，再Developer: Reload Window - 更彻底的方法：命令行启动安全模式
code --disable-extensions，确认高亮恢复后，再逐个启用排查 - 某些插件（如老版
Vetur）会注册自己的 TextMate 语法，但 scope 写错（比如source.js.embedded.html拼成source.js.embeddedhtm），导致匹配失败——这种只能换插件或提 issue
语言模式识别错误：右下角显示 Plain Text 就别折腾主题了
主题再好，语言 ID 错了也白搭。VS Code 靠文件后缀或 shebang 推断 languageId，一旦错配，TextMate 语法不加载，token 根本没生成，自然没东西可着色。
- 点右下角语言标识（如显示
Plain Text），手动选成TypeScript或JavaScript - 检查文件后缀：大小写敏感（
.JS≠.js），拼写错误（.jss、.tsconfig不会被识别为 TS） - 查
files.associations：全局或工作区settings.json里有没有把*.ts错映射成javascript，或者把*.vue映射成html - 新建一个未保存的
test.ts文件，粘贴interface Foo { bar: string }，如果能高亮，说明是当前文件关联或缓存问题，不是主题或扩展
真正麻烦的是语义高亮和 TextMate 规则混用的场景：比如你开了 editor.semanticHighlighting.enabled，又在 settings.json 里自定义了 editor.tokenColorCustomizations，结果语义层的 function 颜色压过了 TextMate 的 entity.name.function——这时候得先决定要哪套逻辑，再清理另一套的干扰项。
