常见问题

常见问题

以下是 Qoder 用户最常遇到的问题和解决方案。如果您的问题没有在这里找到答案，请访问 故障排除指南 或联系我们的支持团队。

💻 安装和启动

Q: Qoder 无法启动怎么办？

A: 请按照以下步骤进行排查：

1. 检查系统要求：

   • Windows: Windows 10 或更高版本
   • macOS: macOS 10.15 (Catalina) 或更高版本
   • 内存: 至少 4GB RAM，建议 8GB 或更多

2. 检查防病软件：

   • 将 Qoder 添加到防病软件的白名单
   • 更新防病软件的病毒库

3. 清理配置文件：

   # Windows
   rd /s /q "%APPDATA%\Qoder"
   
   # macOS
   rm -rf ~/Library/Application\ Support/Qoder

4. 重新安装：

   • 卸载现有版本
   • 从 Qoder 官网 下载最新版本
   • 以管理员权限运行安装程序

Q: 如何更新到最新版本？

A: Qoder 支持多种更新方式：

1. 自动更新（推荐）：

   • 进入 设置 > 更新
   • 开启 自动检查更新
   • Qoder 会在后台检查并提示更新

2. 手动检查：

   • 点击 帮助 > 检查更新
   • 系统会自动下载并安装更新

3. 全新安装：

   • 从官网下载最新安装包
   • 覆盖安装即可，配置会自动保留

🤖 AI 功能使用

Q: AI 建议不准确怎么办？

A: 可以通过以下方式提高 AI 建议质量：

1. 重建项目索引：

   • 右键点击项目文件夹
   • 选择 重建 Qoder 索引
   • 等待索引完成（大型项目可能需要几分钟）

2. 优化上下文配置：

   • 增加相关文件的上下文
   • 排除不必要的文件和文件夹
   • 在 .qoderignore 文件中配置忽略规则

3. 检查 API 密钥设置：

   • 确保 API 密钥正确且有效
   • 检查是否超出使用限制
   • 尝试使用不同的 AI 模型

Q: 为什么代码补全不工作？

A: 可能的原因和解决方案：

1. 语言支持检查：

   • JavaScript/TypeScript ✓
   • Python ✓
   • Java ✓
   • C/C++ ✓
   • C# ✓
   • Go/Rust/PHP/Ruby ✓

2. 项目分析状态：

   • 棄查状态栏的索引进度
   • 等待 项目分析完成 指示器
   • 大型项目初次分析可能需要 10-30 分钟

3. 手动触发：

   • 使用快捷键 Alt + P (Windows) 或 ⌥ + P (macOS)
   • 检查快捷键是否被其他软件占用

⚙️ 配置问题

Q: 设置丢失怎么办？

A: 恢复设置的方法：

1. 检查配置文件权限：

   • 确保 Qoder 有读写权限
   • 检查文件是否被其他程序锁定

2. 从备份恢复：

   # Windows
   copy "%APPDATA%\Qoder\backup\settings.json" "%APPDATA%\Qoder\settings.json"
   
   # macOS
   cp "~/Library/Application Support/Qoder/backup/settings.json" "~/Library/Application Support/Qoder/settings.json"

3. 重置为默认设置：

   • 关闭 Qoder
   • 删除或重命名配置文件夹
   • 重新启动 Qoder

🚀 性能问题

Q: 内存占用过高怎么办？

A: 优化内存使用的方法：

1. 调整缓存设置：

   • 降低最大缓存大小
   • 开启内存优化模式
   • 设置自动清理间隔

2. 排除大文件：

   • 在 .qoderignore 中添加大文件和目录
   • 避免索引二进制文件和日志文件

Q: 索引速度慢怎么办？

A: 加速索引的方法：

1. 优化项目结构：

   • 使用 .qoderignore 排除不必要的文件
   • 优先索引核心代码文件

2. 调整分析深度：

   • 选择适合的分析深度（轻度/中度/深度）
   • 限制最大文件大小
   • 调整并行线程数

🔗 集成问题

Q: GitHub/GitLab 集成失败怎么办？

A: 解决集成问题的步骤：

1. 检查 API 令牌：

   • 确保令牌有效且未过期
   • 检查令牌权限是否足够

2. 网络连接检查：

   • 测试 API 连接是否正常
   • 检查防火墙和代理设置

3. 权限配置：

   • 确保对仓库有读写权限
   • 检查组织级别的权限设置