常见问题 ​

如何查看本地日志？ ​

MAC：打开 CodeBuddy IDE，点击顶部帮助 ---> 打开日志文件夹，找到对应的日志 （.zip） 包

alt text

Windows：

  • 打开 CodeBuddy IDE，点击顶部帮助 ---> 打开日志文件夹，找到对应的日志 （.zip） 包

  • 手动查询路径：C:\Users\<你的用户名>\AppData\Roaming\CodeBuddy\logs（将<你的用户名>替换为 Windows 系统用户名）

账户相关问题 ​

Q: 购买旗舰版后登录提示Credits余额不足 ​

  1. 检查账户是否已购买旗舰版

  2. 检查账户是否还有余额，点击跳转企业后台查询。

  3. 检查是否登录到正确的账号

退出当前账号，通过 手机号 重新登录到旗舰版账号

alt textalt text

远程开发（ SSH 常见问题） ​

Q: 无法连接 ​

远程SSH插件请求/登录报错

需测试下本地IDE是否正常登录, 如果是远程服务器上的请求问题,要确认远程服务器的外网是否可访问, 如使用ping+网址来判断

alt text

如果无法登录，排查如下：

  1. 打开 CodeBuddy IDE 设置 Ctrl/Cmd+,

  2. 搜索 codebuddy.remote.SSH.enableDynamicForwarding

  3. 取消勾选这个选项(设置为 false)

  4. 重新连接 SSH

alt text

打开容器报错

原因是 Codebuddy 上使用的 Vscode 的 Remotessh 和 dev-container 插件, 报错是 Vscode 的插件报错。 使用 Codebuddy IDE 不需要额外安装 Vscode 官方的 Remotessh 和 dev-container 插件, IDE 内置了这两个插件，需要卸载掉 Vscode 的插件使用内置插件连接即可。

alt text

网络检查 ​

  • 3002、3003错误码 ​

检查网络连接/TCP 连接

curl -v https://copilot.tencent.com

检查是否超时

timeout 30s curl -v https://copilot.tencent.com

检查防火墙/代理（CodeBuddy CN IDE不需要通过代理使用）

curl -v --trace-time https://copilot.tencent.com

  • 3005错误码 ​

  1. 点击新建对话/重试即可，网络波动问题可能性较大

  2. 判断输入是否太长了，是否带了很多文件/上下文导致上下文窗口溢出，窗口支持 200K，如果文本内容比较大容易超限，可以只读部分数据来减缓。

  • 10001错误码 ​

若开发环境需使用代理，检查代理服务是否为 HTTP 协议，如果不是建议调整使用 HTTP 协议的代理服务。对于 SOCKS 协议规划支持中

Figma 使用 ​

Q: Figma 无法添加到对话中？ ​

需要申请 Figma 编辑和开发权限，因为 Figma 查看权限默认不开放 Api

开发侧可只开通开发权限，需要先切普通模式再切换到开发模式（ Figma 网页若切换不成功，需手动切换一次）

插件相关 ​

Q: 安装问题 ​

一般是因为本地之前装过错误版本的插件或者有插件迁移导致，以下两个方案选一个执行：

方案一：

  1. 卸载插件；

  2. 清空 cache vsix：help > open Logs Folder > 回退到上一级目录 > cachedVSIXs 的文件夹；

（~/Library/Application\ Support/CodeBuddy\ CN/CachedExtensionVSIXs）

清空本地插件，删除 .codebuddycn/extensions/${插件id}

  1. 重新去插件商店安装；

方案二：

卸载插件，查询一下 Vscode 1.100.0 对应的插件版本，安装指定版本插件

alt text

alt text

Q: Python 没有语法高亮, 无法跳转定义 ​

Plance 校验了微软自己的签名，第三方会有运行不起来的问题"

  1. 卸载 Pylance
  2. 安装 BasedPyrightBasedPyright 默认的检查比较严格，觉得多余可以在设置的这个位置改成 standard：

basedpyright.analysis.typeCheckingMode

alt text

alt text

Q: C/C++ 无法跳转/高亮 ​

  1. C/C++ 微软官方的插件在 CodeBuddy IDE 上会有限制, Codebuddy IDE 建议安装 clangd 作为 c/c++的 lsp (语法高亮和跳转) , 建议安装 clangd 插件进行代码跳转和高亮

注意: 同时要卸载掉 C/C++ 插件, 否则会有冲突

2 如果个别还有问题,确认下项目跟目录是否存在 compile_commands.json文件, 使用如下命令生成:

 cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON

终端 ​

Q: 无法打开终端 ​

操作方法如下：点击顶部CodeBuddy IDE ，查看首选项，选择设置。

alt text

在设置中所搜 Shell，开启 Terminal › Integrated › Shell Integration: Decorations 为 Enabled

alt text

Q: 终端无法复用 ​

MAC

zsh 安装了有慢速组件或者主题会导致获取 Terminal 状态失败

  • 对 zsh 没有诉求的用户，可以考虑更换 bash 主题

alt text

alt text

  • 对 zsh 有诉求的用户，可以排查下 ~/.zshrc 有没有配置类似的主题

alt text

MCP ​

Q: MCP使用 ​

需要在 Craft 模式下使用,Ask 模式不能修改文件，所以禁用了 Mcp，因为 Mcp 可能会修改文件

Q: MCP连接不上 ​

将配置文件内名称有空格的位置删除

alt text