Python文件无高亮，90%是VS Code未启动Python语法解析流程；先点击右下角Plain Text手动切换为Python模式，检查后缀名、files.associations配置及远程Pylance设置是否正确。
Python 文件没高亮，90% 不是主题问题，而是 VS Code 根本没启动 Python 语法解析流程。 点右下角看状态栏：如果显示 Plain Text，别调主题、别重装插件，先解决这个。
右下角显示 Plain Text 怎么办
这是最常见也最容易被跳过的起点。VS Code 不读文件内容，只靠后缀名 + 手动语言模式 + files.associations 配置来决定用哪个语法解析器。
- 点击右下角灰色文字（如
Plain Text），输入python回车，强制切换为 Python 模式 - 检查文件后缀是否拼错：比如
.py_、.PY（部分扩展对大小写敏感）、.pyw（需额外配置） - 在设置中搜索
files.associations，确认没有错误映射，例如"*.py": "json"这类会直接让 Python 文件走 JSON 解析器 - 刚克隆的项目，可临时新建一个空
test.py文件测试——如果它能高亮，说明原文件因路径或配置被误判了
语言模式正确但关键词仍不亮
状态栏已显示绿色 Python，但 import、def、for 等关键字还是灰的，说明 token 生成环节卡住了，常见于语义高亮与主题不兼容或缓存错位。
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），运行Developer: Inspect Editor Tokens and Scopes，把光标停在def上，看 scope 是否含keyword.control.python；若只有keyword，说明主题规则太简陋 - 临时禁用语义高亮验证：
"editor.semanticHighlighting.enabled": false，如果此时关键字恢复颜色，就是语义层和当前主题不匹配 - 删缓存目录：
$HOME/.vscode/Cache/semantic-tokens/（Linux/macOS）或%APPDATA%\Code\Cache\semantic-tokens\（Windows），**必须完全退出 VS Code 进程后再重开** - 检查
settings.json是否被插件注入了空的"editor.tokenColorCustomizations": {}—— Bracket Pair Colorizer 等插件常偷偷写这个，直接删掉整段
远程开发时 Python 关键词不亮但包/变量正常
这种“一半亮一半不亮”的现象，在 Remote-SSH 场景下高频出现，本质是本地和远程两套语言服务器配置未同步，尤其 Pylance 的启用状态容易被忽略。
立即学习“Python免费学习笔记（深入）”；
- 远程连接后，按
Ctrl+Shift+P输入Preferences: Open Settings (JSON)，分别检查以下三处是否都设为pylance： -
"python.defaultInterpreterPath"指向远程有效解释器（如/home/user/miniconda3/bin/python） -
"python.languageServer"在User、Remote、Workspace三个作用域下均明确设为"Pylance" - 若远程端 Pylance 版本过新（如 v2026.5.x），部分用户反馈会导致基础 keyword token 丢失，可回退到稳定版（如 v2026.3.1）再测试
真正卡住人的地方，往往不是“没装插件”，而是 Plain Text 状态被当成小问题忽略，或是远程场景下只配了本地 python.languageServer 却忘了同步远程设置。token scope 和 semantic cache 这类底层机制看不见摸不着，但恰恰是高亮链上最脆弱的一环。
