本页汇总 Kiro 官方 GitHub Issues 和社区踩坑帖子中有明确解决方案的条目。来源包括 kirodotdev/Kiro 仓库 Issues 和 Reddit/Discord 等社区讨论。持续增量更新。

Kiro 已知问题总索引

本索引收录有明确解决方案的 Issues，纯 Feature Request 或无解法的问题不在此列。

GitHub Issues

• Kiro CLI --tui 模式在 RHEL8/Ubuntu20（MUSL 版本）崩溃
• Kiro IDE 不支持 Dev Containers 的临时方案
• Kiro 开始页面最近项目列表只显示 5 个的修改方法
• Kiro CLI 使用 KIRO_API_KEY 认证失败：endpoint 区域错误
• Kiro CLI Agent Hooks 在 2.0.x 版本中完全不触发
• 在 JetBrains IDE 中使用 Kiro 的方法（ACP 集成）
• Kiro IDE 开启 Thinking Mode 和自定义 Subagents
• kiro-cli Windows 原生安装与使用指南
• Kiro 使用 AGENTS.md 定义编码规范（steering 标准）
• Kiro CLI MCP 工具按需加载（Tool Search）
• Kiro CLI 2.0 TUI 模式 MCP Server 不加载的解决方案
• Kiro IDE 被 Windows 杀毒软件误报为病毒的处理方法
• Kiro 更新后 Vue 扩展激活失败（TypeError: isActive undefined）
• Kiro Spec tasks.md 生成后 [Start Task] 按钮不出现的修复方法
• Kiro Chat 终端命令卡在 Working 状态不结束的解决方法
• Kiro IDE Linux 每次启动都弹出设置向导的修复方法

社区踩坑

• [社区] Kiro 终端启动时报 StackOverflowException（Windows）

常见问题

Q: Kiro 安装后无法登录怎么办？

A: 先确认网络能访问 kiro.dev。若在中国大陆使用，需要代理。身份认证走 AWS Cognito，需要能访问 cognito-idp.us-east-1.amazonaws.com。

Q: spec 生成后 AI 不执行怎么办？

A: 需要在 Chat 中明确告诉 Kiro "执行这个 spec"，Kiro 不会自动执行已有的 spec 文件。

Q: hooks 配置后没有触发怎么办？

A: 检查 .kiro/hooks/ 下的 JSON 文件格式是否正确，并确认 trigger 条件（fileEvent/agentHook）与实际操作匹配。