古法编程

Appearance

本文汇总 Kiro 使用中常见问题的解决方案，涵盖 macOS 安装提示损坏、认证跳转失败（Windows 和 macOS）、AWS IAM Identity Center 订阅和会话问题、Shell 集成不可用的手动安装方法、Powerlevel10k 等 Shell 主题冲突、Fish Shell 集成修复、Windows 管理员权限和脚本执行策略问题，以及 MCP server 连接失败的排查步骤。

Kiro 安装问题 ​

macOS：提示 Kiro 已损坏无法打开 ​

在 macOS 上尝试打开 Kiro 时可能会遇到以下错误：

Kiro is damaged and can't be opened. You should move it to the Trash.

这是 macOS 安全功能误报，并非真正损坏。

解决方法（任选其一）：

  • 前往 系统设置 → 隐私与安全性，找到 Kiro 并点击 允许 或 仍然打开
  • 将 Kiro.app 拖到桌面，再从桌面拖回应用程序文件夹，重启电脑
  • 打开终端执行：sudo xattr -d com.apple.quarantine /Applications/Kiro.app

认证问题 ​

认证时无法跳转到浏览器 ​

Windows ​

开启日志模式运行 Kiro 以定位问题：

  1. 以管理员身份打开命令提示符
  2. 运行以下命令（替换为实际的 Kiro 安装路径）：C:\path\to\app.exe --enable-logging
  3. 检查日志中的错误信息
  4. 如果看到拒绝访问的错误，确认你的用户账号有足够权限运行该应用

macOS ​

使用开发者工具诊断问题：

  1. 打开 Kiro
  2. 前往 Help → Toggle Developer Tools
  3. 切换到 Console 标签页
  4. 观察登录过程中出现的错误

常见问题之一是缺少 ioreg 命令：

bash
echo $PATH
which ioreg

如果 ioreg 不在 PATH 中，通常位于 /usr/sbin/ioreg，将该路径加入 PATH 即可。

AWS IAM Identity Center 问题 ​

订阅状态未激活 ​

如果在使用 Identity Center 认证时看到"登录出错"，请确认订阅状态已激活。IAM Identity Center 认证需要有效的订阅。Kiro profiles 目前支持美国东部（弗吉尼亚北部）和欧洲（法兰克福）区域。

会话时长与超时 ​

Identity Center 会话默认超时时间为 8 小时，到期后需要重新认证。如需延长会话时长，管理员可以配置更长的超时时间。详细配置说明请参阅 AWS 文档：配置用户会话时长。

Shell 集成问题 ​

Shell 集成将 Kiro 与终端连接，允许自动执行命令并处理输出结果。没有 Shell 集成，你需要手动复制粘贴终端输出。

快速修复："shell integration unavailable" ​

  1. 更新 Kiro：命令面板（Cmd + Shift + P / Ctrl + Shift + P）→ Kiro: Check for Updates
  2. 启用集成：命令面板 → Kiro: Enable Shell Integration
  3. 重启：完全退出并重新打开 Kiro

手动安装 Shell 集成 ​

如果自动设置失败，手动将以下内容添加到对应的 Shell 配置文件：

Zsh（~/.zshrc）：

bash
[[ "$TERM_PROGRAM" == "kiro" ]] && . "$(kiro --locate-shell-integration-path zsh)"

Bash（~/.bashrc）：

bash
[[ "$TERM_PROGRAM" == "kiro" ]] && . "$(kiro --locate-shell-integration-path bash)"

Fish（~/.config/fish/config.fish）：

bash
string match -q "$TERM_PROGRAM" "kiro"
and . (kiro --locate-shell-integration-path fish)

PowerShell（$Profile）：

powershell
if ($env:TERM_PROGRAM -eq "kiro") { . "$(kiro --locate-shell-integration-path pwsh)" }

Kiro 卡在"Working..."状态或看不到终端输出 ​

如果 Kiro 无法读取终端输出、卡在 Working... 状态，或出现乱码和格式异常，通常是 Shell 自定义配置干扰了终端集成。常见干扰源包括 bash-it、Oh My Posh，以及 Powerlevel10k/9k 等主题。

Powerlevel10k 主题用户 ​

在 .p10k.zsh 文件中添加以下内容：

bash
typeset -g POWERLEVEL9K_TERM_SHELL_INTEGRATION=true

或者在 Kiro 中运行时禁用这些自定义：

zsh（~/.zshrc）：

bash
if [[ "$TERM_PROGRAM" == "kiro" ]]; then
  # 留空，禁用主题
else
  # 你的主题或自定义配置
  ZSH_THEME="powerlevel10k/powerlevel10k"
fi

Fish Shell 用户 ​

如果使用 Fish Shell 并遇到终端输出问题，可能需要手动修改 Kiro 的 Shell 集成脚本。该文件位于：

/Applications/Kiro.app/Contents/Resources/app/out/vs/workbench/contrib/terminal/common/scripts/shellIntegration.fish

默认情况下，集成脚本只检测 "vscode"：

fish
status is-interactive
and string match --quiet "$TERM_PROGRAM" "vscode"
and ! set --query VSCODE_SHELL_INTEGRATION
or exit

将其更新为同时包含 "kiro"：

fish
status is-interactive
and string match --quiet "$TERM_PROGRAM" "vscode" "kiro"
and ! set --query VSCODE_SHELL_INTEGRATION
or exit

Windows 特有问题 ​

因管理员安装导致更新被禁用 ​

如果遇到以下错误：

Updates are disabled because you are running the user-scope installation of Kiro as Administrator.

取消以管理员身份运行的设置：

  1. 右键单击 Kiro 图标
  2. 选择 显示更多选项
  3. 选择 属性
  4. 切换到 兼容性 标签页
  5. 取消勾选 以管理员身份运行此程序
  6. 点击 应用 然后 确定

完成后 Kiro 即可正常更新。

无法运行脚本 ​

在 PowerShell 7+ 中设置执行策略：

检查当前策略：

powershell
Get-ExecutionPolicy

设置执行策略：

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

OneDrive 路径问题 ​

如果你在 Windows 上使用 OneDrive，桌面路径可能导致问题：

  1. 以管理员身份启动命令提示符
  2. 创建符号链接：mklink /J "C:\Users\<username>\Desktop" "C:\Users\<username>\OneDrive\Desktop"
  3. 重启 IDE

MCP Server 连接问题 ​

常见 MCP 连接问题排查 ​

  1. 检查服务器状态：打开 Kiro 面板，导航到 MCP servers 标签页，查看连接状态指示器
  2. 验证配置：确认 MCP 配置文件的语法正确，检查 server 命令和参数是否正确
  3. 检查前置条件：确认所有必要依赖已安装（例如 AWS Documentation server 需要 Python 3.10+ 和 uv）
  4. 查看日志：打开 Kiro 的 Output 面板，从下拉列表选择 "Kiro - MCP Logs"，查找具体错误信息

修复特定 MCP 问题 ​

AWS 文档 Server ​

连接失败时验证环境：

bash
# 验证 uv 安装
uv --version

# 验证 Python 版本（需要 3.10+）
python --version

# 直接测试 server
uvx awslabs.aws-documentation-mcp-server@latest --help

搜索或读取失败时：检查网络连接、验证文档页面的 URL 格式、尝试更简单的搜索关键词。

GitHub MCP Server ​

认证错误：验证 Personal Access Token 是否有效，确认 Token 具有所需权限（repo、user），必要时重新生成 Token。

请求频率限制：GitHub API 有使用限制，在 MCP 日志中检查频率限制状态，考虑使用有更高限额的 Token。

获取帮助 ​

如果以上排查步骤无法解决问题：

  1. 查阅 FAQ 寻找常见问题解答
  2. 加入 Discord 社区 寻求帮助
  3. 在 GitHub 提交 Issue，包含：
    • 你的操作系统详情
    • Kiro 版本号
    • 已尝试的排查步骤
    • 错误信息（如有）

常见问题 ​

Q：Shell 集成手动安装后仍然不生效，怎么办？

首先确认修改的是正确的配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bashrc），然后重新打开终端（而不是仅刷新配置）。如果使用了 Powerlevel10k 或其他主题框架，需要额外按照对应章节处理，因为这些框架可能覆盖终端集成设置。

Q：MCP server 连接时断时续，如何稳定？

先检查 "Kiro - MCP Logs" 中的具体错误，排除网络波动和依赖版本问题。如果是 AWS 相关 server，确认 uv 和 Python 版本符合要求，并尝试直接在终端运行 server 命令验证其是否正常工作。

Q：macOS 上用 xattr 命令解除隔离后仍然无法打开 Kiro 怎么办？

确认命令中路径正确，并且以 sudo 权限执行。如果仍然失败，尝试将应用移出并重新移入应用程序文件夹，或在"系统设置 → 隐私与安全性"中手动允许运行。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策