codebuddy本身不负责语法高亮，问题根源在于ide语言服务链断裂；需依次确认语言模式与文件绑定、重启pylance语言服务器、清理语义缓存及排查插件冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 本身不负责语法高亮，它依赖 VS Code 或 PyCharm 等 IDE 的语言服务（如 Pylance、Python 扩展）来提供基础高亮。如果你发现 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.languageServer"显式设为"Pylance"（不是None或Microsoft）； - 完全退出 VS Code（包括后台进程），再重新打开 —— 仅重载窗口无法重启 LSP。
清理语义缓存与冲突插件
缓存错位或插件抢占会导致 token 着色规则失效，表现为关键词全灰、括号不匹配。
- 删除语义缓存目录：
- Windows：
%APPDATA%\Code\Cache\semantic-tokens\ - macOS/Linux：
$HOME/.vscode/Cache/semantic-tokens/
- Windows：
- 重启后仍无效，临时禁用所有非必要插件（尤其 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或端口占用提示； - 若有，尝试在命令行中手动杀掉残留进程：
pkill -f codebuddy-lsp（macOS/Linux）或任务管理器结束相关 node.exe 进程（Windows）； - 重启 IDE 后，再检查右下角 CodeBuddy 图标是否显示“已登录”且无报错。
不复杂但容易忽略
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
