CodeBuddy插件安装失败需按四类路径排查：一、检查DNS解析与网络连通性，替换为114.114.114.114等可信DNS；二、绕过市场手动安装ZIP/Vsix包；三、彻底清除IDE中codebuddy插件缓存目录；四、验证IDE版本≥2023.3、管理员权限运行、禁用代理及杀毒软件干扰。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy插件安装失败，通常不是单一原因导致，而是网络、环境、缓存或权限多个环节中某一处卡住。处理时不必重装IDE或反复卸载插件，按以下四类路径逐项排查，90%以上问题可快速定位并解决。
一、检查网络连通性与DNS解析
DNS解析失败是安装阶段最常见的“假超时”原因——界面显示“连接重置”或“网络超时”，但实际是域名根本没解析出来。尤其在校园网、企业内网或使用某些ISP宽带时容易发生。
- Windows：以管理员身份运行命令提示符，依次执行：
ipconfig /flushdns
ping cdn.codebuddy.cn（若无响应，说明DNS或路由异常）
然后进入网络适配器属性 → IPv4 → 手动设置DNS为114.114.114.114和223.5.5.5 - macOS/Linux：终端执行
sudo dscacheutil -flushcache（macOS）或 sudo systemd-resolve --flush-caches（Linux）
再运行 dig +short cdn.codebuddy.cn @114.114.114.114，确认返回腾讯云IP（如182.254.x.x）
二、绕过市场直接手动安装
当插件市场搜索不到、点击安装无反应或提示“Connection reset”但状态码为200时，说明下载链路被代理、防火墙或本地安全软件干扰，建议跳过市场直装。
- 前往CodeBuddy官网下载最新版插件包（.zip或.vsix格式）
- IntelliJ IDEA：Settings → Plugins → ⚙️右下角齿轮 → Install plugin from disk → 选中下载文件
- VS Code：Ctrl+Shift+P → 输入Extensions: Install from VSIX → 选择文件 → 重启编辑器
三、清除IDE缓存与插件残留
旧版本插件配置损坏、缓存冲突或Token残留，会导致新安装包加载失败或登录卡死。这不是重装能解决的，必须清理本地状态。
- 完全退出IDE（任务管理器确认java.exe或code进程已结束）
- 删除对应目录下的插件缓存：
Windows：%USERPROFILE%\.IntelliJIdea\config\plugins\codebuddy
macOS：~/Library/Caches/JetBrains/IdeaIC/plugins/codebuddy
VS Code：~/.vscode/extensions/tencent.codebuddy-* - 再启动IDE，重新安装并扫码登录
四、验证基础环境与权限
部分报错表面是“安装失败”，实则源于底层依赖缺失或权限不足，尤其在Windows系统或公司管控设备上较常见。
- 确保IDE版本≥2023.3（Help → About 查看），低于此版本API不兼容，插件无法初始化
- Windows用户请用管理员身份运行IDE，避免因写入权限不足导致插件解压失败
- 禁用杀毒软件实时防护（如360、火绒）、关闭系统代理（设置 → 网络 → 代理 → 关闭自动检测）
- 终端执行 curl -Iv https://downloads.marketplace.jetbrains.com，观察TLS握手是否成功、证书是否可信
