语义着色未生效需先确认editor.semanticHighlighting.enabled为true；VS Code 1.85+默认关闭该功能，即使安装cpptools、Pylance或TypeScript扩展也需手动启用，并验证语言服务器是否提供semantic token及主题是否映射对应token类型。
语义着色根本没生效？先确认 editor.semanticHighlighting.enabled 是 true
VS Code 1.85+ 默认关闭语义高亮，哪怕你装了 cpptools、Pylance 或最新版 TypeScript 扩展，editor.semanticHighlighting.enabled 也默认是 false。这不是 bug，是 VS Code 故意设为 opt-in——怕大项目下拖慢渲染。
实操建议：
- 打开
settings.json，加这一行："editor.semanticHighlighting.enabled": true - 别只在 UI 设置里勾选，有些语言（如 Python）会忽略全局设置，得加语言专属配置：
"python.editor.semanticHighlighting.enabled": true - 改完不用重启，但当前文件可能不立即响应：右键编辑器 → Developer: Reload Window，或保存后切出再切回标签页
颜色还是不对？检查语言服务器是否真发出了 semantic token
开了开关 ≠ 有 token。很多扩展（尤其是旧版 C/C++ 插件或未启用 Pylance 的 Python）根本不提供语义 token，或者只在特定条件下才发（比如项目根目录缺 tsconfig.json 或 compile_commands.json）。
实操建议：
- 按
Ctrl+Shift+P→ 运行 Developer: Inspect Editor Tokens and Scopes，把光标停在变量名上（比如count） - 看弹出面板里有没有
semantic token type字段，值是不是variable.local、parameter、function这类；没有就说明语言服务压根没传 - C/C++：确认右下角有 C/C++ 图标，且状态栏显示
IntelliSense: Ready；没显示就检查c_cpp_properties.json或是否生成了正确的编译数据库 - Python：必须装
ms-python.pylance（不是ms-python.python），并在settings.json加"pylance.semanticTokens": true
token 有了但颜色没变？主题没映射 variable.local 这类 token 类型
VS Code 只下发 token 类型（如 variable.local），最终着色全靠当前主题的 semanticTokenColors 字段。大量第三方主题（One Dark Pro、Nord、Dracula）至今没加这个字段，导致语义 token 被静默丢弃，回退到无色或 TextMate 默认色。
实操建议：
- 临时切换到 VS Code 自带的
Dark+或Light+主题，再跑一次 Inspect Editor Tokens and Scopes，如果这时变量突然有颜色了，就是你当前主题的问题 - 不想换主题？可手动补映射：在
settings.json加editor.semanticTokenColorCustomizations，例如："editor.semanticTokenColorCustomizations": { "rules": { "variable.local": "#abb2bf", "parameter": {"foreground": "#56b6c2", "italic": true}, "function": "#98c379" } } - 注意：
variable这种泛化名通常不命中，得用带修饰符的完整名（variable.local、variable.parameter）
颜色闪一下就消失？很可能是语言服务返回空 token 导致刷新清空
这是 C/C++ 插件（cpptools）v1.19–v1.21 常见缺陷：首次解析时返回 token（着色闪现），随后收到构建系统（CMake/Make）触发的重索引请求，语言服务重算时返回空数组，VS Code 就把已渲染的颜色全清掉，且不再恢复。
实操建议：
- 查插件版本：右下角 C/C++ 图标 → 点开 → 看版本号；若在 v1.19–v1.21 区间，直接降级到 v1.18.5 或升级到 v1.22+
- 关掉自动构建监听：在
settings.json加"C_Cpp.autocompleteAddParentheses": false和"C_Cpp.intelliSenseEngine": "Default"（避免 clangd 模式下更频繁刷新） - 临时禁用构建产物监控：删掉或重命名
build/目录下的compile_commands.json，观察是否还闪退
真正卡住人的地方，往往不是“怎么开”，而是“开了之后谁在中间拦路”——语言服务器没发 token、主题没接住 token、插件版本有 bug，三者任一断掉，颜色就消失。最省时间的做法，永远是先用 Developer: Inspect Editor Tokens and Scopes 看一眼，而不是反复调主题或重装插件。
