VSCode代码全白主因是语言模式未识别：先点击右下角强制切换为javascript/python/typescript，检查文件后缀与files.associations配置是否正确，再清理语义缓存、禁用冲突扩展并启用内置语言服务。
VSCode代码全白，八成是编辑器根本没识别出你在写什么语言——不是主题坏了，也不是插件失效，而是语法解析器压根没启动。
右下角显示 Plain Text 怎么办
这是最常见也最高概率的起点。VS Code 不靠文件内容判断语言，只认后缀名、files.associations 配置和你手动指定的 languageId。一旦状态栏显示 Plain Text，整个 token 生成链就断了。
- 点击右下角灰色文字（哪怕它看起来是空白），输入
javascript、python或typescript回车，强制切换 - 勾选 “Configure
javascriptlanguage based settings” 可把这次选择设为该后缀默认值 - 检查文件后缀是否拼错：
.jss≠.js，.PY在 Linux/macOS 下可能不匹配"*.py": "python" - 新建无后缀文件（如粘贴一段代码）时，默认就是
Plain Text，必须手动指定
files.associations 配错导致高亮全崩
一条错误的 files.associations 就能让整个项目代码变白板，而且不报错、不提示，只安静地“装死”。
- 常见错误：
"*.ts": "javascript"→interface、as const全部不识别；"*.vue": "html"→<script setup>和defineProps全白 - 大小写敏感：Linux/macOS 下
"*.JS": "javascript"必须单独加，否则file.JS不生效 - 通配符只支持
*和**，不支持正则；value 必须是合法 languageId（比如typescriptreact✅，jsx❌） - 改完配置后需关闭文件再重开，或执行
Developer: Reload Window（不是Ctrl+R）
语义高亮与主题不兼容，关键词还是灰的
语言模式正确但 const、def、import 仍无色，大概率是语义层（semantic tokens）没渲染出来，或当前主题压根没定义对应 scope。
- 临时关掉语义高亮：
"editor.semanticHighlighting.enabled": false，如果此时关键字恢复颜色，说明是语义层和主题不匹配 - 删缓存目录：
%APPDATA%\Code\Cache\semantic-tokens\（Windows）或$HOME/.vscode/Cache/semantic-tokens/（macOS/Linux），**必须完全退出 VS Code 进程后再重开** - 检查
settings.json是否被插件注入空的"editor.tokenColorCustomizations": {}——Bracket Pair Colorizer等常偷偷写这个，直接删掉整段 - 用
Developer: Inspect Editor Tokens and Scopes查看真实 scope：鼠标停在function上，若显示keyword.control.js但无颜色，是主题缺规则；若 scope 是string或为空，说明语言服务解析失败
扩展冲突或语言服务器静默降级
某些扩展会劫持语言服务，或语言服务器启动失败却不报错，导致 VS Code 显示 Python 或 Vue，实际只走基础 TextMate 规则——from typing import 不提示、defineProps 不跳转、#include 不变橙色。
- 执行
Extensions: Disable All Installed Extensions+Developer: Reload Window，若恢复，说明是扩展问题 - Vetur 和 Volar 同时启用必炸；旧版 Python 扩展与 Pylance 共存也可能错乱
- 打开
Output面板 → 切换到Log (Extension Host)，搜索failed to activate或language server crashed - Volar 必须开启
Volar: Take Over Mode，然后关闭并重新打开整个窗口（仅重载无效） - 远程开发（如 Remote-SSH）时，确认
"python.languageServer"在 User、Remote、Workspace 三个作用域下均明确设为"Pylance"
真正卡住的点往往不在表面：比如 files.associations 写错一条，或语义缓存卡在旧版本，或远程端 Pylance 版本过新导致 keyword token 不返回——这些都不会弹红框，只会默默给你一张白纸。
