故障排除
常见问题
安装和启动问题
Kiro 无法启动
症状: 应用程序启动时崩溃或无响应
解决方案:
- 确认系统要求：
- Windows 10+、macOS 10.15+ 或 Linux
- 4GB RAM（推荐 8GB）
- 2GB 可用磁盘空间
- 重新安装 Kiro
- 检查系统日志中的错误消息
- 临时禁用防病毒软件进行测试
权限错误
症状: “权限被拒绝”或无法访问文件
解决方案:
- 以管理员权限运行 Kiro（Windows）
- 检查文件和文件夹权限
- 确保 Kiro 有写入工作目录的权限
AI 和聊天问题
AI 无响应
症状: 聊天面板中没有收到 AI 回复
解决方案:
- 检查网络连接
- 验证 Kiro 账户状态
- 重启聊天会话
- 检查 API 限制和配额
聊天上下文丢失
症状: AI 似乎忘记了之前的对话
解决方案:
- 使用
#codebase或#file提供更多上下文 - 在单个会话中保持相关对话
- 创建新的聊天会话重新开始
项目和文件问题
文件未同步
症状: 更改未反映在编辑器中
解决方案:
- 手动刷新文件资源管理器
- 重新加载工作区
- 检查文件是否被其他程序锁定
Git 集成问题
症状: Git 状态不正确或命令失败
解决方案:
- 验证 Git 是否正确安装
- 检查仓库状态：
git status - 确认远程连接：
git remote -v - 重新初始化 Git 集成
性能问题
编辑器响应缓慢
症状: 输入延迟或界面冻结
解决方案:
- 关闭不必要的文件和标签页
- 禁用资源密集型扩展
- 增加可用内存
- 检查大文件处理
高 CPU/内存使用
症状: 系统资源使用率过高
解决方案:
- 监控活动进程
- 限制并发聊天会话
- 调整索引设置
- 重启应用程序
扩展和集成问题
MCP 服务器连接失败
症状: MCP 功能不可用
解决方案:
- 验证 MCP 服务器配置
- 检查网络连接和防火墙
- 验证 API 密钥和令牌
- 查看 MCP 日志获取详细错误
钩子无法执行
症状: 代理钩子触发但不执行
解决方案:
- 检查钩子配置语法
- 验证触发条件
- 查看钩子执行日志
- 测试简化版本的钩子
调试技巧
日志和诊断
启用详细日志
- 打开设置
- 搜索”日志级别”
- 设置为”详细”或”调试”
- 重启 Kiro
查看日志文件
位置:
- Windows:
%APPDATA%\Kiro\logs\ - macOS:
~/Library/Application Support/Kiro/logs/ - Linux:
~/.config/Kiro/logs/
收集诊断信息
- 使用命令面板：
Kiro: Export Logs - 包含相关错误消息
- 记录重现步骤
- 截图问题界面
性能分析
监控资源使用
- 使用任务管理器（Windows）或活动监视器（macOS）
- 识别高资源使用的进程
- 分析内存和 CPU 模式
优化设置
- 调整编辑器设置
- 限制并发操作
- 配置缓存和索引
- 优化项目结构
获取帮助
自助资源
- 文档 - 完整的产品文档
- [社区论坛] - 用户社区支持
- [知识库] - 常见问题解答
技术支持
- 通过应用内支持系统
- 提供详细的问题描述
- 包含系统信息和日志
- 描述重现步骤
报告错误
- 使用 GitHub Issues（如果可用）
- 包含重现步骤
- 提供系统环境信息
- 附加相关截图或日志
预防措施
定期维护
- 保持 Kiro 更新到最新版本
- 定期清理临时文件和缓存
- 备份重要配置和项目
- 监控系统性能指标
最佳实践
- 使用版本控制管理项目
- 定期备份工作
- 保持系统和依赖项更新
- 遵循推荐的项目结构
页面最后更新：2025年7月14日