CodeBuddy Study Guide

Appearance

常见问题 ​

本页面收集了用户在使用CodeBuddy过程中最常遇到的问题和解决方案。

快速导航 ​

安装相关问题 ​

Q1: 如何查看本地日志？ ​

A: 点击 Help → Open Logs Folder 打开本地文件夹，找到今天的日志压缩包并发送。

Q2: 远程SSH连接失败，提示"Could not establish connection to" ​

A: 根据VSCode官方文档，从1.99版本开始，远程开发功能强制要求远程主机具有glibc>=2.28。

解决方案：

  1. 检查远程主机的glibc版本：
    bash
    ldd --version
  2. 如果版本过低，需要升级系统或使用支持的版本

Q3: 在应用商店搜索安装插件时看到"版本不兼容"消息 ​

A: 在IDE设置中搜索"gallery"，然后配置为 https://marketplace.visualstudio.com 并重启IDE。

Q4: 无法安装C/C++扩展 ​

A:

  • 方案1: 安装特定的较低版本
  • 方案2: 安装clangd作为替代

Q5: 终端无法执行终端命令 ​

错误信息: 如下所示的错误，表明需要设置shell集成开关为Enable。

解决方案:

  1. 在设置中搜索"shell"
  2. 启用Terminal Integrated Shell Integration为Enable

使用相关问题 ​

Q6: 如何选择和导入Figma图片到IDE中？ ​

A:

  1. 开发者需要先申请Figma权限
  2. 点击对应图片，需要用腾讯企业微信邮箱登录
  3. 使用过程中，按照图片操作并添加到对话中

Q7: 如何新建对话或查看对话历史？ ​

A:

  • 新建对话: 点击左侧的"+"按钮
  • 查看历史: 右侧显示对话历史记录

Q8: 如何配置主题？ ​

A:

  1. 点击Theme，选择Configure Theme
  2. 可用的主题选项包括：
    • Color Theme（颜色主题）
    • File Icon Theme（文件图标主题）
    • Product Icon Theme（产品图标主题）

Q9: 如何通过终端命令快捷方式快速打开IDE开发窗口？ ​

A:

  1. 使用 Up Arrow ↑ + Command + P 打开安装窗口
  2. 输入"buddy"进行安装
  3. 安装成功后，在终端中执行命令，例如：
    bash
    buddy .

性能相关问题 ​

Q10: CodeBuddy响应速度慢怎么办？ ​

A:

  1. 检查网络连接: 确保网络稳定
  2. 切换模型: 选择更快的模型如Gemini-2.5-Flash
  3. 清理缓存: 重启IDE清理缓存
  4. 减少上下文: 减少不必要的文件上下文

Q11: 智能补全不准确怎么办？ ​

A:

  1. 添加更多上下文: 包含相关文件和文档
  2. 使用更强模型: 切换到Claude-4.0-Sonnet
  3. 优化代码注释: 提供更清晰的注释说明
  4. 设置项目规则: 在Rules中定义编码规范

功能相关问题 ​

Q12: Agent模式无法理解我的需求 ​

A:

  1. 使用更具体的描述: 提供详细的功能需求
  2. 添加示例: 提供期望的输入输出示例
  3. 分步骤描述: 将复杂任务分解为简单步骤
  4. 添加上下文: 关联相关的文件和文档

Q13: 内联聊天修改的代码不符合预期 ​

A:

  1. 选择更精确的代码范围: 只选择需要修改的部分
  2. 提供更清晰的修改说明: 详细描述期望的变更
  3. 使用示例: 提供修改前后的对比示例
  4. 多次迭代: 可以多次使用内联聊天进行调整

Q14: 如何使用计划模式？ ​

A:

  1. 在Agent面板中切换到"Plan Mode"
  2. 输入详细的项目需求描述
  3. CodeBuddy会生成结构化的PRD文档
  4. 按照生成的计划逐步执行任务

Q15: MCP集成如何配置？ ​

A:

  1. 在快速操作中选择"Config MCP"
  2. 配置数据源连接信息
  3. 测试连接是否成功
  4. 在上下文中添加MCP数据源

故障排除 ​

常见错误代码 ​

错误代码描述解决方案
E001网络连接超时检查网络连接，重试请求
E002API配额超限等待配额重置或升级账户
E003模型服务不可用切换到其他可用模型
E004上下文过大减少上下文文件数量
E005权限不足检查账户权限设置

诊断步骤 ​

当遇到问题时，按以下步骤进行诊断：

  1. 检查基本环境

    bash
    # 检查版本
codebuddy --version

# 检查网络
ping api.codebuddy.ai

  2. 查看日志文件

    • 打开日志文件夹
    • 查看最新的错误日志
    • 记录错误信息

  3. 重启服务

    bash
    # 重启CodeBuddy
# Windows: 关闭程序重新打开
# macOS: Cmd+Q 然后重新启动
# Linux: killall codebuddy && codebuddy

  4. 清理缓存

    • 清理IDE缓存
    • 重置用户设置
    • 重新登录账户

联系支持 ​

如果以上方法都无法解决问题，可以通过以下方式获取帮助：

  1. 官方文档: https://www.codebuddy.ai/docs
  2. GitHub Issues: 提交详细的问题报告
  3. 社区论坛: 在用户社区寻求帮助
  4. 技术支持: 联系官方技术支持团队

问题报告模板 ​

提交问题时，请包含以下信息：

**问题描述**
简要描述遇到的问题

**复现步骤**
1. 第一步
2. 第二步
3. 第三步

**期望结果**
描述期望的正确行为

**实际结果**
描述实际发生的情况

**环境信息**
- 操作系统: 
- CodeBuddy版本: 
- 使用的模型: 
- 相关插件: 

**日志信息**
粘贴相关的错误日志

**截图**
如果有必要，请提供截图

更多资源 ​

如果你的问题没有在这里找到答案，欢迎在GitHub上提交Issue或联系我们的技术支持团队。

Released under the MIT License.

Copyright © 2025 CodeBuddy Study Guide