codebuddy补全失效需按五步排查：一查右下角语言模式是否为plain text；二验插件是否启用且版本兼容；三测登录状态及codebuddy.tencentcloudapi.com连通性；四重启codebuddy-lsp进程并校验端口配置；五禁用冲突插件并清除缓存重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy代码补全突然不生效，不是插件“坏了”，而是某个环节断链了——可能是右下角语言模式被误点成Plain Text，也可能是刚升级IDE后插件自动禁用，还可能是公司防火墙今天恰好拦截了codebuddy.tencentcloudapi.com的443端口。别急着重装，先按顺序查这五个关键断点。
第一步：看右下角语言模式是不是“失联”了
点击VS Code或IntelliJ右下角显示的语言标识（比如Python、JavaScript），如果看到的是【Plain Text】或【Unknown】，补全引擎根本不会启动，所有后续排查都白费力气。
手动选回对应语言，例如.py文件必须选Python，.vue文件必须选Vue（不是Vue HTML），.ts文件必须选TypeScript。
注意：未保存的临时文件（如Untitled-1）默认就是Plain Text，补全永远不会触发——先Ctrl+S保存为test.py再试。
第二步：确认插件是否真在运行
打开IDE设置 → 插件管理页（VS Code点Extensions，IntelliJ点Settings → Plugins）。
找到“腾讯云代码助手 CodeBuddy”，检查右侧状态是不是Enabled；如果显示Disabled或版本号是灰色，说明插件没加载成功。
若已启用但无响应，直接卸载→重启IDE→从codebuddy.cloud下载最新安装包重装，旧版插件可能与当前IDE内核不兼容。
第三步：验证登录状态和网络连通性
方法一：看状态栏图标
点击IDE右下角CodeBuddy图标，必须显示用户头像或“已登录”；若显示“去登录”，用微信扫码完成鉴权——Token过期或未授权会导致所有补全请求返回401错误。
方法二：终端直连测试
在系统终端执行：curl -v https://codebuddy.tencentcloudapi.com/health，返回HTTP 200且含{"status":"ok"}才算通。返回超时或403，说明网络链路被拦。
若公司使用Clash/Surge等代理工具，临时关闭代理再试；企业网络环境下，需确认防火墙是否放行codebuddy.tencentcloudapi.com的HTTPS（443）出向连接。
第四步：重启语言服务器进程
CodeBuddy依赖独立的codebuddy-lsp进程提供语义分析能力，该进程崩溃或端口冲突会导致补全完全静默。
① 打开终端，执行：
macOS/Linux：ps aux | grep codebuddy-lsp
Windows：tasklist | findstr codebuddy-lsp
若无结果，说明进程未运行。
② 进入CodeBuddy插件安装目录下的lsp子目录，手动启动：
macOS/Linux：./codebuddy-lsp --port=43210
Windows：codebuddy-lsp.exe --port=43210
③ 在IDE设置中确认LSP连接地址为http://127.0.0.1:43210，协议类型必须是【HTTP】而非HTTPS或WS——配错协议会导致连接拒绝。
第五步：排除插件冲突和缓存污染
方法一：临时禁用冲突插件
VS Code中按Ctrl+Shift+P → 输入“Extensions: Show Enabled Extensions”，依次禁用名称含“Copilot”“Tabnine”“Whisper”“IntelliCode”的扩展，每禁用一个就重启IDE测试补全是否恢复。
方法二：清除本地索引缓存
删除CodeBuddy插件的缓存目录：
VS Code：~/.vscode/extensions/tencent.codebuddy-*/languageServerData
IntelliJ：~/.cache/JetBrains/IntelliJIdea*/plugins/codebuddy/cache
删完重启IDE，让LSP重建项目上下文索引。
