你是否也曾遇到 Python 代码语法高亮突然不亮的困扰？先别急着把问题归咎于 CodeBuddy。实际上，语法着色并非 CodeBuddy 的核心职责——它需要依赖 VS Code 或 PyCharm 这类 IDE 内置的语言服务（比如 Pylance、Python 扩展）来提供基础颜色。当代码突然变得灰蒙蒙一片时，问题的根源通常不在 CodeBuddy 插件本身，而是底层的语言支持链路发生了断裂。修复的关键，在于重新激活 IDE 对 Python 代码的语义识别能力，让语法高亮恢复正常。

那么，从哪里开始排查？先从最基础的语言模式入手。

确认语言模式与文件绑定是否正确

VS Code 或 PyCharm 必须准确识别当前文件为 Python，否则连 def、import 这类核心关键字都不会正常着色。这个细节看似简单，却最容易在排查中被忽略。

• 点击编辑器右下角状态栏的语言标识（例如显示“Plain Text”或空白），然后手动切换为 Python；
• 确认文件后缀名是 .py —— 如果使用了 .pyw、.pyi，还需在 settings.json 中显式绑定对应的语言模式；
• 刚克隆下来的项目，请确保根目录包含 pyproject.toml 或 requirements.txt，这些文件是 Pylance 启动语义分析的关键信号；
• 在 VS Code 中打开命令面板（Ctrl+Shift+P），运行 Python: Select Interpreter，确认已选中一个可用的 Python 环境。

检查并重启 Python 语言服务器

语法高亮失效的另一个常见原因，是 Pylance 或 Python 扩展的语言服务器（LSP）根本没有启动，或者在运行中悄然崩溃。

• 打开 VS Code 的 Output 面板 → 切换到 Log (Extension Host)，搜索 failed to activate 或 language server crashed 等异常信息；
• 如果发现 Pylance 启动失败，请进入设置，检查 python.defaultInterpreterPath 是否指向正确的 Python 解释器路径；
• 在设置中将 "python.languageServer" 显式设为 "Pylance"（切勿设为 None 或 Microsoft）；
• 然后——完全退出 VS Code（记得关闭后台进程），再重新启动。仅重载窗口是不够的，语言服务器不会随之重启。

清理语义缓存与冲突插件

缓存错乱或插件冲突，同样会导致 token 着色规则失效，结果就是关键字全部变灰、括号匹配异常。

• 删除语义缓存目录：
  • Windows：%APPDATA%CodeCachesemantic-tokens
  • macOS/Linux：$HOME/.vscode/Cache/semantic-tokens/
• 重启后如果问题依旧，建议临时禁用所有非必要插件——尤其是 Bracket Pair Colorizer、Highlight Matching Tag 这类 UI 类扩展；
• 检查 settings.json 中是否被写入了空的 "editor.tokenColorCustomizations": {}，如有则直接删除；
• 另外可尝试临时关闭语义高亮：将 "editor.semanticHighlighting.enabled" 设为 false。如果基础关键字恢复了颜色，说明问题出在语义层与当前主题不兼容。

验证 CodeBuddy 是否干扰语言服务

虽然 CodeBuddy 不直接负责语法高亮，但它自身的 LSP 进程一旦出现异常，也可能拖累 IDE 整体的语言服务稳定性。

• 在终端执行 curl -v https://codebuddy.tencentcloudapi.com/health，确认服务可正常访问（返回 HTTP 200）；
• 打开 Output 面板 → 切换到 CodeBuddy 日志，查看是否存在 LSP initialization failed 或端口冲突等错误提示；
• 如果发现问题，可尝试在命令行中手动清理残留进程：macOS/Linux 使用 pkill -f codebuddy-lsp，Windows 则通过任务管理器结束相关的 node.exe 进程；
• 重启 IDE 后，观察右下角 CodeBuddy 图标是否显示“已登录”，且无任何报错信息。

总的来说，这些排查步骤并不复杂，但在实际诊断中确实容易被遗漏。按照上述顺序逐一检查，基本能够解决绝大多数 Python 代码语法高亮不亮的问题，让 IDE 的代码着色恢复正常。